Loading
Semântica do Tableau
Usar a função DATEPARSE

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:

Formatos com suporte para a função DATEPARSE
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 e respeita a localidade e qual dia da semana é considerado como o início da semana, como domingo ou segunda-feira.

Comportamento do ano

  • yy retorna 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 IW ou YYYY ww, não IYYY ww ou YYYY 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 A retorna 00:00:00.
  • c — dia da semana independente. O uso de c causa 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 EEEE seja suportado.
  • Y/AAAA – não há suporte para variações nos formatos de ano ISO. O uso de Y ou YYY causa 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

 
Carregando
Salesforce Help | Article