Função UNIXTIMEFORMAT

Formata um conjunto de data/hora Unix de acordo com uma string especificada de formatação de data.

Os valores de origem podem ser uma referência a uma coluna com valores de carimbo de data/hora.

OBSERVAÇÃO: os valores de data precisarão ser convertidos em carimbos de data/hora Unix para aplicar esta função. O tempo Unix mede o número de milissegundos decorridos desde 1º de janeiro de 1970 00:00:00 (UTC). Consulte Função UNIXTIME.

As strings de formato aceitável dessa função são as mesmas da função DATEFORMAT. Para mais informações sobre esses valores de string, consulte Tipos de dados aceitos.

  • Para mais informações sobre como formatar formatos de data Unix ou padrão, consulte Função DATEFORMAT.
  • Para mais informações sobre como formatar tipos numéricos, consulte Função NUMFORMAT.

Uso básico

derive type:single value: UNIXTIMEFORMAT(MyUnixDate, 'yyyy-MM-dd') as: 'unixDate'

Resultado: gera uma coluna de valores Datetime na coluna unixDate, com base na coluna MyUnixDate de valores de carimbo de data/hora Unix, que são convertidos no formato ano-mês-dia.

Sintaxe

derive type:single value:UNIXTIMEFORMAT(unixtime_col, date_format_string)

ArgumentoObrigatório?Tipo de dadosDescrição
unixtime_colSdatetimeNome da coluna cujos valores de carimbo de data/hora Unix precisam ser formatados
date_format_stringSstringLiteral de string que identifica o formato da data para aplicar ao valor

Para mais informações sobre os padrões de sintaxe, consulte Notas de sintaxe da documentação da linguagem.

unixtime_col

Nome da coluna com os dados de tempo Unix que precisam ser formatados.

  • Os valores ausentes nos dados de origem dessa função resultam em valores ausentes na saída.
  • Não há compatibilidade com colunas múltiplas e caracteres curinga.

Observações sobre o uso:

Obrigatório?Tipo de dadosValor de exemplo
SimDatetime (formatados como valores de inteiro de tempo Unix)myDate

date_format_string

Valor de string que indica o formato de data para aplicar aos valores de entrada.

OBSERVAÇÃO: se a plataforma não puder reconhecer a string de formato de data, o resultado gerado será escrito como um valor de string.

Veja a seguir mais informações sobre as strings de formatação aceitas.

  • Os valores ausentes nos dados de origem dessa função resultam em valores ausentes na saída.
  • Não há compatibilidade com colunas múltiplas e caracteres curinga.

Observações sobre o uso:

Obrigatório?Tipo de dadosValor de exemplo
SimString'MM/dd/yyyy'

Exemplos

Exemplo: variações de formatação do carimbo de data/hora Unix

DescriçãoColuna unixTimestampTransformaçãoColuna newUnixTimestamp
Data numérica, ano primeiro

1454946120000

1451433600000

1430032020000

derive type:single value:UNIXTIMEFORMAT(unixTimestamp,'yyyy-MM-dd') as:'newUnixTimestamp'

2016-02-08

2015-12-30

2015-04-26

Data numérica, estilo americano

1454946120000

1451433600000

1430032020000

derive type:single value:UNIXTIMEFORMAT(unixTimestamp,'M/d/yy') as:'newUnixTimestamp'

2/8/16

12/30/15

4/26/15

Data escrita por extenso

1454946120000

1451433600000

1430032020000

derive type:single value:UNIXTIMEFORMAT(unixTimestamp,'MMMM dd, yyyy') as:'newUnixTimestamp'

8 de fevereiro de 2016

30 de dezembro de 2015

26 de abril de 2015

Data abreviada,
incluindo dia da semana
abreviado

1454946120000

1451433600000

1430032020000

derive type:single value:UNIXTIMEFORMAT(unixTimestamp,'EEE MMM dd, yyyy') as:'newUnixTimestamp'

Seg 08 fev, 2016

Qua 30 dez, 2015

Dom 26 abr, 2015

Horário completo no formato 24 horas

1454946120000

1451433600000

1430032020000

derive type:single value:UNIXTIMEFORMAT(unixTimestamp,'HH:mm:ss.SSS') as:'newUnixTimestamp'

15:42:00.000

00:00:00.000

07:07:00.00

Horário no formato 12 horas com indicador AM/PM

1454946120000

1451433600000

1430032020000

derive type:single value:UNIXTIMEFORMAT(unixTimestamp,'h:mm:ss a') as:'newUnixTimestamp'

OBSERVAÇÃO: para essa função, o uso do indicador de horas em minúscula (h ou hh) requer o uso do indicador AM/PM (a).

3:42:00 PM

12:00:00 AM

7:07:00 AM

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Google Cloud Dataprep
Precisa de ajuda? Acesse nossa página de suporte.