TODATE

Esta função só funciona com as datas do modo de compatibilidade.

Recomendamos que você faça upgrade de todos os campos de data mais antigos das suas fontes de dados para os novos tipos de "Data" ou "Data e hora". Após fazer upgrade:

• Você pode usar a função FORMAT_DATETIME para formatar uma data como texto.
• Use as funções PARSE_DATE e PARSE_DATETIME para converter texto em campos de "Data" e "Data e hora".

Saiba mais

É possível usar TODATE de duas maneiras:

• Criar uma data do modo de compatibilidade a partir de campos de texto.
• Mudar o formato de exibição e a granularidade de uma data do modo de compatibilidade.

Exemplo de uso

TODATE(Text_Date,"%Y/%m/%d","%Y-%m-%d")

 

TODATE(Text_Date,"%Y/%m/%d","%Y-%m-%d")

 

TODATE(Response_Time, 'MILLIS', '%Y%m%d')

 

TODATE(Created_Time, 'DECIMAL_DATE', '%Y')

Sintaxe

TODATE(field_expression, input_date_format, output_date_format)

Formatos de entrada

input_date_format será opcional se field_expression for configurado corretamente como uma data semântica.

A função TODATE aceita as seguintes strings de formato de entrada:

• 'BASIC': %Y/%m/%d-%H:%M:%S

• 'DEFAULT_DASH': %Y-%m-%d [%H:%M:%S]

• 'DEFAULT_SLASH': %Y/%m/%d [%H:%M:%S]

• 'DEFAULT_DECIMAL': %Y%m%d [%H:%M:%S

• 'RFC_1123': por exemplo, Sat, 24 May 2008 20:09:47 GMT

• 'RFC_3339': por exemplo, 2008-05-24T20:09:47Z

• 'SECONDS': segundos desde a Era Unix

• 'MILLIS': milissegundos desde a Era Unix

• 'MICROS': microssegundos desde a Era Unix

• 'NANOS': nanossegundos desde a Era Unix

• 'JULIAN_DATE': dias desde a Era Unix

• 'DECIMAL_DATE': igual a 'DEFAULT_DECIMAL'

• Qualquer formato strptime válido. Opcional se o valor já for um campo de data e hora.

Formatos de saída

A função TODATE aceita as seguintes strings de formato de saída:

• "%Y": ano
• "%m": mês
• "%d": dia
• "%W": número da semana do ano
• "%w": dia da semana
• "%H": hora
• "%M": minuto

Exemplos

Example formula	Input	Output
TODATE(Text_Date,"%Y/%m/%d","%Y-%m-%d")	2024/05/09	2024-05-09
TODATE(Response_Time, 'MILLIS', '%Y%m%d')	1715294861000	20240509
TODATE(Created_time, 'DECIMAL_DATE', '%Y')	20240509 [11:34:12]	2024

Observações

TODATE retorna tipos de dados de "Data" do modo de compatibilidade.

Recursos relacionados

• Datas e horas
• Campos calculados
• Lista de funções do Looker Studio