Campos de data e hora

Se você estiver trabalhando com campos que contenham informações de data ou carimbo de data e hora no seu aplicativo, é possível definir vários atributos relacionados de uma data, como, por exemplo, ano ou semana, e utilizá-los na sua visualização.

Criando campos de data no Gerenciador de dados

Campos de data são criados automaticamente para todos os campos de dados reconhecidos como um carimbo de data ou de hora quando você usar Adicionar dados com a análise de dados para construir seu modelo de dados no Gerenciador de dados ou quando você clicar em Carregar dados no Gerenciador de dados.

Os campos de data criados no Gerenciador de dados são adicionados automaticamente ao autoCalendar.

Para obter mais informações, consulte Carregando e gerenciando dados com o Gerenciador de dados.

Se o campo de data ou de carimbo de data e hora não for reconhecido automaticamente, você pode ajustar o formato de entrada no editor de tabelas do Gerenciador de dados. Você também pode definir o formato de exibição para usar em visualizações.

Para obter mais informações, consulte Alterando tipos de campo.

Quais campos de data e hora são reconhecidos automaticamente?

Campos de data e de carimbo de data e hora serão reconhecidos automaticamente com base nas configurações locais do sistema. Além disso, os seguintes formados são reconhecidos:

M/D/YYYY h:mm
D/M/YYYY h:mm TT
M/D/YYYY
D/MM/YYYY
YYYYMMDD
YYYYMMDDhhmmss
YYYYMMDDhhmmss.fff
YYYYMMDDhhmmssK
YYYY-MM-DD
YYYY-MM-DDThh:mm:ss
YYYY-MM-DD-Thh:mm:ss.fff
YYYY-MM-DD-Thh:mm:ssK

Formatos de data e hora
Especificador de formato	Descrição
YYYY	Ano
M, MM	Mês
D, DD	Dia
hh	Hora
mm	Minuto
ss	Segundo
fff	Milissegundo
TT	AM ou PM
K	Fuso horário
T	Divisor entre data e hora. T não pode ser substituído por outro caractere.

Criando campos de data e hora no script de carregamento de dados

Se usar o editor de carregamento de dados para construir seu modelo de dados, você precisa criar um modelo de calendário em que define quais campos derivar no script de carregamento de dados. Os campos derivados de data e hora serão gerados quando o script e os dados forem executados.

Para obter mais informações, consulte Campos derivados.

Usando campos de data e hora no aplicativo

Campos de data e hora nas visualizações

Todos os campos de data ou de carimbo de data e hora na guia Campos do painel de ativos são marcados com , e você pode expandi-los para usar os campos de data e hora gerados. Você pode utilizá-los em visualizações como qualquer outro campo de dados.

Campos de data e hora nas dimensões

Você também pode usar os campos de data e hora ao criar uma dimensão. Os campos de data e hora são listados sob o campo do qual foram gerados.

Campos de data e hora nas expressões

Você pode usar os campos de data e hora em todas as expressões, por exemplo, ao criar uma medida. Os campos de data e hora são nomeados de acordo com:

[nome do campo].autoCalendar.[campo de data e hora].

[nome do campo] é o nome do campo de dados que foi usado para gerar campos de data e hora.
[campo de data e hora] é o campo de data e hora que você deseja usar, por exemplo, Year.

Exemplo:

Date.autoCalendar.Year

Campos de data e hora em medidas de calendário

Medidas de calendário usam campos de data e hora criados no autoCalendar. Cada um desses campos de data e hora é calculado por uma expressão de análise de conjunto que determina se os dados se enquadram no período de tempo acumulado até a data ou se as datas estão em uma posição relativa à data atual. Esses campos de data e hora são relativos e retornam resultados com base na data atual. Você pode usar esses campos independentemente das medidas de calendário.

Campos de data e hora de campos de calendário são formatados da seguinte maneira:

[nome do campo].autoCalendar.[campo de data e hora]={[value]}

[nome do campo] é o nome do campo de data usado para gerar campos de data e hora.
[campo de data e hora] é o nome do campo de data e hora usado, por exemplo, InYTD.
[valor] é o valor da expressão de análise de conjunto do campo de data e hora e determina quais datas estão incluídas.

Exemplo:

Date.autoCalendar.YearsAgo={1}

Veja a seguir os campos de data e hora disponíveis com valores de amostra:

Esse campo de data e hora determina se as datas estão dentro ou fora do intervalo acumulado no ano.

InYTD
Exemplo	Resultado
Date.autoCalendar.InYTD={0}	Retorna todas as datas que caem no intervalo de tempo acumulado no ano. Por exemplo, se a data atual fosse o 54º dia do ano, as datas dentro dos primeiros 54 dias de cada ano no campo de data seriam incluídas.
Date.autoCalendar.InYTD={1}	Retorna todas as datas fora do intervalo de tempo acumulado no ano. Por exemplo, se a data atual fosse o 54º dia do ano, todas as datas após os primeiros 54 dias de cada ano no campo de data seriam incluídas.

Esse campo de data e hora determina se as datas são de um determinado ano em relação à data atual.

YearsAgo
Exemplo	Resultado
Date.autoCalendar.YearsAgo={0}	Retorna todas as datas deste ano.
Date.autoCalendar.YearsAgo={1}	Retorna todas as datas do ano passado.
Date.autoCalendar.YearsAgo={8}	Retorna todas as datas de oito anos atrás.

Esse campo de data e hora determina se as datas estão dentro ou fora do intervalo acumulado no trimestre, em relação à data atual.

InQTD
Exemplo	Resultado
Date.autoCalendar.InQTD={0}	Retorna todas as datas de todos os trimestres que estão dentro do intervalo acumulado no trimestre. Por exemplo, se a data atual fosse o 14° dia do Trimestre 1, os primeiros 14 dias de cada trimestre no campo de data seriam incluídos.
Date.autoCalendar.InQTD={1}	Retorna todas as datas de todos os trimestres que estão fora do intervalo acumulado no trimestre atual. Por exemplo, se a data atual fosse o 14° dia do Trimestre 1, todas as datas após os primeiros 14 dias de cada trimestre no campo de data seriam incluídas.

Esse campo de data e hora determina se as datas são de um determinado trimestre em relação à data atual.

QuartersAgo
Exemplo	Resultado
Date.autoCalendar.QuartersAgo={0}	Retorna todas as datas do trimestre atual.
Date.autoCalendar.QuartersAgo={1}	Retorna todas as datas do trimestre passado.
Date.autoCalendar.QuartersAgo={8}	Retorna todas as datas de oito trimestres atrás.

Esse campo de data e hora determina se as datas são de um determinado trimestre em relação à data atual.

QuarterRelNo
Exemplo	Resultado
Date.autoCalendar.QuarterRelNo={0}	Retorna todas as datas de cada instância do trimestre atual. Por exemplo, se a data atual fosse no Trimestre 4, todas as datas de cada Trimestre 4 no campo de data seriam incluídas.
Date.autoCalendar.QuarterRelNo={3}	Retorna todas as datas de cada instância do trimestre, dois trimestres antes do atual. Por exemplo, se a data atual fosse no Trimestre 4, todas as datas de cada Trimestre 1 no campo de data seriam incluídas

Esse campo de data e hora determina se as datas estão dentro ou fora do intervalo acumulado no mês, em relação à data atual.

InMTD
Exemplo	Resultado
Date.autoCalendar.InMTD={0}	Retorna todas as datas de todos os meses que estão dentro do intervalo atual acumulado no mês. Por exemplo, se a data fosse 15 de novembro de 2016, as datas dos 15 primeiros dias de cada mês no campo de data seriam incluídas.
Date.autoCalendar.InMTD={1}	Retorna todas as datas de todos os meses que estão fora do intervalo atual acumulado no mês. Por exemplo, se a data fosse 15 de novembro de 2016, as datas depois dos 15 primeiros dias até o final de cada mês no campo de data seriam incluídas.

Esse campo de data e hora determina se as datas são de um determinado mês em relação à data atual.

MonthsAgo
Exemplo	Resultado
Date.autoCalendar.MonthAgo={0}	Retorna todas as datas do mês atual.
Date.autoCalendar.MonthAgo={1}	Retorna todas as datas do mês passado.
Date.autoCalendar.MonthAgo={8}	Retorna todas as datas de oito meses atrás.

Esse campo de data e hora determina se as datas são de um determinado mês em relação à data atual.

MonthRelNo
Exemplo	Resultado
Date.autoCalendar.MonthRelNo={0}	Retorna todas as datas de cada instância do mês atual. Por exemplo, se o mês atual fosse junho, todas as datas de cada instância de junho no campo de data seriam incluídas.
Date.autoCalendar.MonthRelNo={1}	Retorna todas as datas de cada instância do mês passado. Por exemplo, se o mês atual fosse junho, todas as datas de cada instância de maio no campo de data seriam incluídas.

Esse campo de data e hora determina se as datas estão dentro ou fora do intervalo acumulado na semana, em relação à data atual.

InWTD
Exemplo	Resultado
Date.autoCalendar.InWTD={0}	Retorna todas as datas de todas as semanas que estão dentro do intervalo atual acumulado na semana. Por exemplo, se a data atual fosse o terceiro dia de uma semana, as datas dos primeiros três dias de cada semana no campo de data seriam incluídas.
Date.autoCalendar.InWTD={1}	Retorna todas as datas de todos os meses que estão fora do intervalo atual acumulado no mês. Por exemplo, se a data atual fosse o terceiro dia de uma semana, as datas dos últimos quatro dias de cada semana no campo de data seriam incluídas.

Esse campo de data e hora determina se as datas são de uma determinada semana em relação à semana atual.

WeeksAgo
Exemplo	Resultado
Date.autoCalendar.WeeksAgo={0}	Retorna todas as datas da semana atual.
Date.autoCalendar.WeeksAgo={8}	Retorna todas as datas de oito semanas atrás.

Esse campo de data e hora determina se as datas são de uma determinada semana em relação à data atual.

WeekRelNo
Exemplo	Resultado
Date.autoCalendar.WeekRelNo={0}	Retorna todas as datas de cada instância da semana atual. Por exemplo, se a semana atual fosse a segunda semana do ano, as datas da segunda semana de cada ano no campo de data seriam incluídas.
Date.autoCalendar.WeekRelNo={1}	Retorna todas as datas de cada instância da semana anterior. Por exemplo, se a semana atual fosse a segunda semana do ano, as datas da primeira semana de cada ano no campo de data seriam incluídas.

Saiba mais

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!

Deixe seu feedback aqui