TODATE

Retorna uma data formatada no modo de compatibilidade.

É 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 é opcional quando field_expression está 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

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.