Função UNIXTIME

Deriva o valor Unixtime (ou tempo de época) de um Datetime. O valor da origem pode ser uma referência a uma coluna contendo valores Datetime.

Hora Unix é um formato de data e hora usado para expressar o número de milissegundos que decorreu desde 1º de janeiro de 1970 00:00:00 (UTC).

  • Hora Unix não lida com os segundos extras que ocorrem no dia extra dos anos bissextos.

Essa função considera qualquer valor de fuso horário nas entradas.

  • Se você tem uma coluna com vários fusos horários, é possível converter a coluna em Unixtime para que possa executar as operações de Data/Hora com um fuso horário padronizado.
  • Se quiser trabalhar com horários locais, você poderá truncar o fuso horário ou usar outras funções de Data.
  • Se o valor Datetime inicial não incluir uma entrada válida para esta função, um valor ausente será retornado.

Uso básico

derive type:single value:UNIXTIME(MyDate)

Resultado: gera uma coluna de valores que calcula os valores de tempo Unix da coluna MyDate.

Sintaxe

derive type:single value:UNIXTIME(datetime_col)

ArgumentoObrigatório?Tipo de dadosDescrição
datetime_colSdatetimeNome da coluna cujos valores de hora Unix serão calculados

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

datetime_col

Nome da coluna cujo valor de hora Unix será calculado.

  • Os valores ausentes nos dados de origem desta função geram valores ausentes na saída.
  • Os valores de origem inválidos ou fora do intervalo geram valores ausentes na saída.
  • Várias colunas e caracteres curinga não são aceitos.
  • Inclui deslocamento de fuso horário quando converte valores de data/hora para unixtime.
  • Se o valor da data não inclui um fuso horário, o Unixtime usa UTC (0:00).

Observações de uso:

Obrigatório?Tipo de dadosValor de exemplo
SimDatetimemyDate

Exemplos

Exemplo: geração e formatação de hora Unix

Este exemplo ilustra como é possível usar funções para manipular valores de hora Unix em uma coluna do tipo Datetime.

  • UNIXTIME: retorna o valor da hora Unix calculada a partir de um valor Datetime. Consulte Função UNIXTIME.
  • UNIXTIMEFORMAT: formata um valor de hora Unix da maneira especificada. Consulte Função UNIXTIMEFORMAT.

Origem:

date
08/02/16 15:41
30/12/15 0:00
26/04/15 7:07

Transformação:


Use o código a seguir para gerar uma coluna contendo os valores acima como valores do código de hora Unix:

derive type:single value: UNIXTIME (date)

Resultados:

OBSERVAÇÃO: se o valor Datetime de origem não contiver uma entrada válida para uma dessas funções, nenhum valor será retornado.

datadata_unixtime
08/02/16 15:411454946120000
30/12/15 0:001451433600000
26/04/15 7:071430032020000

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.