Você está aqui:
Usar a função DATEPARSE
A função DATEPARSE pega essa entrada de string e o formato especificado pelo usuário e retorna um campo de data.
As datas são armazenadas em strings em vários padrões (por exemplo, YYYY-MM-DD, DDMMMMYY e MMM DD, YYYY). Quando esses campos são tratados como strings, eles não têm a funcionalidade de um campo com um tipo de dados Data, como detalhamento de hierarquia de datas, datas contínuas e manipulação de partes de data.
Se alterar o tipo de dados de string para data não funcionar, use a função DATEPARSE para converter o campo em um tipo de dados de data. A sintaxe é DATEPARSE("format", string).
- O valor de formato é uma string embutida em código com base nos formatos com suporte.
- O valor da string pode ser um campo ou um valor embutido em código.
O formato deve ser fornecido para evitar erros como reverter o mês e o dia em diferentes localidades, como:
Saídas de DATEPARSE("MMDDYYYY", "03112028") 11 de março de 2026.
Saídas de DATEPARSE("DDMMYYYY", "03112028") 3 de novembro de 2026.
A função DATEPARSE suporta os formatos mencionados nesta tabela:
| Unidade de tempo | Formato | Saída de exemplo |
|---|---|---|
| Ano | yy y, aaaa |
26 2026 |
| Trimestre | Q/q QQ/qq |
2 02 |
| Mês | M MM MMM MMMM |
9 09 Sep Setembro |
| Mês independente | L LL LLL LLLL |
9 09 Sep Setembro |
| Semana do ano (1-53) | w ww |
1 47 |
| Dia do mês | d dd |
|
| Dia do ano | D DD DDD |
3 25 143 |
| Dia da semana local (depende da localidade) | e ee eee eeee |
1 01 Sol ou segunda-feira Domingo ou segunda-feira |
| Dia da semana | E EE EEE EEEE |
Gem Quarta-feira |
Hora (12h) (1-12) |
h uh |
8 08 |
Hora (24h) (0-23) |
H HH |
8 15 |
| Minuto | m mm |
8 08 |
| Segundo | s ss |
8 08 |
| Segundo fracionário | S SS SSS (até seis casas decimais) |
2 23 235 (até seis casas decimais) |
| Ano ISO | d dd |
Ano ISO |
| Semana ISO | IW |
Semana ISO |
Notas sobre o uso dos formatos
Contribuições
- A entrada de formato deve ser texto embutido em código dentro da função.
- Entradas inválidas causam falhas de consulta em vez de saída nula.
- As entradas do trimestre devem ser de 1 a 4 ou 01 a 04.
- Há suporte para segundos fracionários com até seis casas decimais.
- Os fusos horários são ignorados.
-
O dia da semana local
erespeita a localidade e qual dia da semana é considerado como o início da semana, como domingo ou segunda-feira.
Comportamento do ano
yyretorna o ano com dois dígitos. Para anos com dois dígitos abaixo de 70, o século é 2000s, ou 2000+aaaa. Para anos com dois dígitos 70 e superiores, o século é 1900, ou 1900+aaaa.-
Para meses independentes (sem especificação de ano), o ano padrão é 0001. Esse formato é diferente do Tableau Classic, que usa 1900 como padrão.
Formatos ISO
- Evite misturar partes de data ISO e não ISO e evite misturar padrões ISO. Por exemplo, use
IYYY IWouYYYY ww, nãoIYYY wwouYYYY IW. - Formatos que especificam o Ano ISO também devem especificar a Semana ISO. Sem a Semana ISO, o ano gregoriano é retornado. Esse formato difere do Tableau Classic, que retorna o ano ISO mesmo sem a semana.
Formatos sem suporte que estão disponíveis no Tableau Classic:
- A – milissegundos em um dia não são suportados. Em vez de soltar ou arredondar o tempo, o
Aretorna 00:00:00. - c — dia da semana independente. O uso de
ccausa erros e uma falha de consulta. - EEEEE/EEEEEE – dias de semana curtos (como T ou Tu) causam erros e uma falha de consulta, apenas até que
EEEEseja suportado. - Y/AAAA – não há suporte para variações nos formatos de ano ISO. O uso de
YouYYYcausa erros e uma falha de consulta.
Exemplos
MM/dd/yyyy HH:mm:ss → 09/22/2018 13:05:00
ddMMMMYY → 20February2021
2016-06-04T1430 → YYYY-MM-dd'T'Hmm
