Função DATETIME

Gera um valor Datetime das seguintes entradas do tipo Integer: ano, mês, dia, hora, minuto e segundo.

  • Os valores de origem podem ser literais inteiros ou referências de coluna a valores que podem ser inferidos como Inteiros.
  • Se algum dos valores de origem for inválido ou estiver fora do intervalo, um valor ausente será retornado.
  • Essa função precisa ser aninhada dentro de outra função que aceita valores de data como argumentos. Veja o exemplo abaixo.

Uso básico

Valores literais inteiros:

derive value: DATEFORMAT(DATE(2015,02,15, 2, 4, 0),'yyyy-MM-dd:HH:mm:ss')

Resultado: gera uma coluna de valores contendo o valor de data formatado: 2015-02-15:02:04:00.

Valores de referência de coluna:

derive value: DATEFORMAT(DATE(myYear, myMonth, myDay, myHour, myMin, mySec),'MMM yyyy - HH:MM:SS')

Resultado: gera uma coluna de valores de data em que:

  • MMM = valor abreviado de myMonth
  • yyyy = valor de myYear
  • HH = valor de myHour
  • MM = valor de myMin
  • SS = valor de mySec

Sintaxe

derive value:DATEFORMAT(date(year_integer_col,month_integer_col,day_Integer_col, hour_Integer_col, minute_Integer_col,second_Integer_col),'date_format_string')

ArgumentoObrigatório?Tipo de dadosDescrição
year_integer_colSnúmero inteiroNome da coluna ou literal inteiro que representa o valor do ano para aplicar à função
month_integer_colSnúmero inteiroNome da coluna ou literal inteiro que representa o valor do mês para aplicar à função
day_integer_colSnúmero inteiroNome da coluna ou literal inteiro que representa o valor do dia para aplicar à função
hour_integer_colSnúmero inteiroNome da coluna ou literal inteiro que representa o valor da hora a ser aplicado à função
minute_integer_colSnúmero inteiroNome da coluna ou literal inteiro que representa o valor do minuto a ser aplicado à função
second_integer_colSnúmero inteiroNome da coluna ou literal inteiro que representa o segundo do dia para aplicar à função
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 as Observações sobre a sintaxe da documentação da linguagem.

year_integer_col

Literal inteiro ou nome da coluna que contém valores inteiros referentes ao ano.

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

Observações de uso:

Obrigatório?Tipo de dadosValor do exemplo
SimInteiro (referência de coluna ou literal)2015

month_integer_col

Literal inteiro ou nome da coluna que contém valores inteiros referentes ao mês.

  • Os valores precisam ser 1 ou mais, com um valor máximo de 12.
  • Os valores ausentes nos dados de origem dessa função resultam em valores ausentes na saída.
  • Não há compatibilidade com várias colunas e caracteres curinga.

Observações de uso:

Obrigatório?Tipo de dadosValor do exemplo
SimInteiro (referência de coluna ou literal)4

day_integer_col

Literal inteiro ou nome da coluna que contém valores inteiros referentes ao dia.

  • Os valores precisam ser 1 ou mais, com um valor máximo de 31.
  • Os valores ausentes nos dados de origem dessa função resultam em valores ausentes na saída.
  • Não há compatibilidade com várias colunas e caracteres curinga.

Observações de uso:

Obrigatório?Tipo de dadosValor do exemplo
SimInteiro (referência de coluna ou literal)26

hour_integer_col

Literal inteiro ou nome da coluna que contém valores inteiros referentes à hora.

  • Os valores precisam ser 0 ou mais, com um valor máximo de 23.
  • Os valores ausentes nos dados de origem dessa função resultam em valores ausentes na saída.
  • Não há compatibilidade com várias colunas e caracteres curinga.

Observações de uso:

Obrigatório?Tipo de dadosValor do exemplo
SimInteiro (referência de coluna ou literal)21

minute_integer_col

Literal inteiro ou nome da coluna que contém valores inteiros referentes ao minuto.

  • Os valores precisam ser 0 ou mais, com um valor máximo de qualquer minuto de 59.
  • Os valores ausentes nos dados de origem dessa função resultam em valores ausentes na saída.
  • Não há compatibilidade com várias colunas e caracteres curinga.

Observações de uso:

Obrigatório?Tipo de dadosValor do exemplo
SimInteiro (referência de coluna ou literal)04

second_integer_col

Literal inteiro ou nome da coluna que contém valores inteiros referentes aos segundos.

  • Os valores precisam ser 0 ou mais, com um valor máximo de qualquer segundo de 59.
  • Os valores ausentes nos dados de origem dessa função resultam em valores ausentes na saída.
  • Não há compatibilidade com várias colunas e caracteres curinga.

Observações de uso:

Obrigatório?Tipo de dadosValor do exemplo
SimInteiro (referência de coluna ou literal)15

date_format_string

Para mais informações sobre as strings de formatação de dados aceitas, consulte Tipos de dados compatíveis.

Para mais informações, consulte Função DATEFORMAT.

Exemplos

Exemplo - funções de data e hora

Neste exemplo ilustramos como as funções DATE e TIME funcionam. Nas duas, é necessário que as saídas sejam formatadas corretamente usando a função DATEFORMAT.

  • DATE: gera valores Datetime válidos a partir de três entradas de inteiros: ano, mês e dia. Consulte Função DATE.
  • TIME: gera valores Datetime válidos a partir de três entradas de inteiros: hora, minuto e segundo. Consulte Função TIME.
  • DATETIME: gera valores Datetime válidos a partir de seis entradas de inteiros: ano, mês, dia, hora, minuto e segundo. Consulte a função DATETIME.
  • DATEFORMAT: formata valores Datetime válidos de acordo com a string de formatação fornecida. Consulte Função DATEFORMAT.

Fonte:

yearmonthdayhourminutesecond
20161011230
20151120152230
20141225183045

Transformação:

derive value: DATEFORMAT(DATE (year, month, day),'yyyy-MM-dd') as:'fctn_date'

derive value: DATEFORMAT(TIME (hour, minute, second),'HH-mm-ss') as:'fctn_time'

derive value: DATEFORMAT(DATETIME (year, month, day, hour, minute, second),'yyyy-MM-dd-HH:mm:ss') as:'fctn_datetime'


Resultados:

OBSERVAÇÃO: todas as entradas têm que ser inferidas como tipo Inteiro e precisam ser valores válidos para a entrada especificada. Por exemplo, é necessário que os valores referentes a mês sejam inteiros de 1 a 12.

yearmonthdayhourminutesecondfctn_datefctn_timefctn_datetime
201610112302016-10-1102-03-002016-10-11-02:03:00
201511201522302015-11-2015-22-302015-11-20-15:22:30
201412251830452014-12-2518-30-452014-12-25-18:30:45

Você pode aplicar outras funções de data e hora às colunas geradas.

Consulte um exemplo em Função YEAR.

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.