# Campos de data e hora

Se você estiver trabalhando com campos que contenham informações de data ou carimbo de data/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.

Nota informativa

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](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/managing-data.htm).

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](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/changing-date-time-format.htm).

### 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 carga de dados

Se você usar o Editor de carregamento de dados para construir seu modelo de dados, precisará criar um modelo de calendário onde você define quais campos derivar nos dados carregar script. 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](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/derived-fields.htm).

## 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 the Data e hora icon, 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]={[valor]}

* [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:

#### InYTD

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}<br>` | Retorna todas as datas que caem no intervalo de tempo acumulado no ano.<br><br>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}<br>` | Retorna todas as datas fora do intervalo de tempo acumulado no ano.<br><br>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. |

#### YearsAgo

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. |

#### InQTD

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.<br><br>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.<br><br>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. |

#### QuartersAgo

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

QuartersAgoQuartersAgo

| 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. |

#### QuarterRelNo

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

QuarterRelNoQuarterRelNo

| Exemplo | Resultado |
| --- | --- |
| `Date.autoCalendar.QuarterRelNo={0}` | Retorna todas as datas de cada instância do trimestre atual.<br><br>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.<br><br>Por exemplo, se a data atual fosse no Trimestre 4, todas as datas de cada Trimestre 1 no campo de data seriam incluídas |

#### InMTD

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.

InMTDInMTD

| 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.<br><br>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.<br><br>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. |

#### MonthsAgo

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

MonthsAgoMonthsAgo

| 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. |

#### MonthRelNo

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

MonthRelNoMonthRelNo

| Exemplo | Resultado |
| --- | --- |
| `Date.autoCalendar.MonthRelNo={0}` | Retorna todas as datas de cada instância do mês atual.<br><br>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.<br><br>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. |

#### InWTD

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.

InWTDInWTD

| Exemplo | Resultado |
| --- | --- |
| `Date.autoCalendar.InWTD={0}` | Retorna todas as datas de todas as semanas que estão dentro do intervalo atual acumulado na semana.<br><br>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.<br><br>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. |

#### WeeksAgo

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

WeeksAgoWeeksAgo

| 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. |

#### WeekRelNo

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

WeekRelNoWeekRelNo

| Exemplo | Resultado |
| --- | --- |
| `Date.autoCalendar.WeekRelNo={0}` | Retorna todas as datas de cada instância da semana atual.<br><br>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.<br><br>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

* [Criar medidas de calendário](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Measures/create-calendar-measure.htm)