Função MONTH

Deriva o valor inteiro do mês de um valor Datetime. O valor de origem pode ser uma referência a uma coluna contendo valores Datetime ou um literal.

OBSERVAÇÃO: se o valor de data/hora de origem não incluir uma entrada válida para esta função, será retornado um valor ausente.

Uso básico

derive type:single value:MONTH(MyDate)

Resultado: gera uma coluna de valores que incluem os valores numéricos do mês a partir da coluna MyDate.

Sintaxe

derive type:single value:MONTH(datetime_col)

ArgumentoObrigatório?Tipo de dadosDescrição
datetime_colSdatetimeNome da coluna cujos valores do mês precisam ser computados

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

datetime_col

Nome da coluna cujo valor do mês precisa ser calculado.

  • 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
SimData/horamyDate

Exemplos

Exemplo: funções do elemento Date

Este exemplo ilustra como várias funções relacionadas à data podem ser usadas para derivar valores específicos de uma coluna de data/hora.

  • YEAR: retorna o valor do ano com quatro dígitos de um valor de data/hora. Consulte Função YEAR.
  • MONTH: retorna o valor do mês com dois dígitos de um valor de data/hora. Consulte Função MONTH.
  • MONTHNAME: retorna o valor do nome completo do mês de um valor de data/hora. Consulte Função MONTHNAME.
  • DAY: retorna o dia do mês como um valor numérico de um valor de data/hora. Consulte Função DAY.
  • HOUR: retorna o valor da hora em uma escala de 24 horas de um valor de data/hora. Consulte Função HOUR.
  • MINUTE: retorna o valor dos minutos de um valor de data/hora. Consulte Função MINUTE.
  • SECOND: retorna o valor dos segundos de um valor de data/hora. Consulte Função SECOND.

Origem:

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

Transformação:

derive type:single value: YEAR (date)

derive type:single value: MONTH (date)

derive type:single value: MONTHNAME (date)

derive type:single value: DAY (date)

derive type:single value: HOUR (date)

derive type:single value: MINUTE (date)

derive type:single value: SECOND (date)

Resultados:

OBSERVAÇÃO: se o valor de data/hora da origem não contiver uma entrada válida para uma dessas funções, não será retornado nenhum valor. Consulte a coluna second_date a seguir.

dateyear_datemonth_datemonthname_dateday_datehour_dateminute_datesecond_date
08/02/16 15:4120162February81541
30/12/15 0:00201512December3000
26/04/15 7:0720154April2677

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.