Função DATE

Gera um valor de data a partir de três entradas do tipo inteiro: ano, mês e dia.
  • 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 em outra função que aceita valores de data, como DATEFORMAT, como argumentos. Consulte o exemplo abaixo.

Uso básico

Valores literais inteiros:

derive type:single value: DATEFORMAT(DATE(2015,02,15),'yyyy-MM-dd')

Saída: gera uma coluna de valores que contém o valor de data formatado: 2015-02-15.

Valores de referência de coluna:

derive type:single value: DATEFORMAT( DATE(myYear, myMonth, myDay),'MMM yyyy')

Saída: gera uma coluna de valores de data em que:

  • MMM = valor abreviado de myMonth
  • yyyy = valor de myYear

Sintaxe

derive type:single value:DATEFORMAT(DATE(year_integer_col,month_integer_col,day_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
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 de 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 colunas múltiplas e caracteres curinga.

Observações sobre o uso:

Obrigatório?Tipo de dadosValor de 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 colunas múltiplas e caracteres curinga.

Observações sobre o uso:

Obrigatório?Tipo de dadosValor de 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 colunas múltiplas e caracteres curinga.

Observações sobre o uso:

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

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 Função DATETIME.
  • DATEFORMAT: formata valores Datetime válidos de acordo com a string de formatação fornecida. Consulte Função DATEFORMAT.

Origem:

anomêsdiahoraminutosegundo
20161011230
20151120152230
20141225183045

Transformação:

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

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

derive type:single 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.

anomêsdiahoraminutosegundofctn_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. Veja 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.