Função TIME

Gera valores de tempo a partir de três entradas de tipo Inteiro: 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 type:single value: DATEFORMAT(TIME(23,58,59),'HH mm ss')

Saída: gera uma coluna de valores que contém o mapa:

23 58 59

Valores de referência de coluna:

derive type:single value: DATEFORMAT(TIME(myHour, myMinute, mySecond), 'hh-mm-ss')

Resultado: gera uma coluna de valores em que:

  • hh = valores da coluna myHour
  • mm = valores da coluna myMinute
  • ss = valores da coluna mySecond

Sintaxe

derive type:single value:DATEFORMAT(TIME(hour_integer_col,minute_integer_col,second_integer_col ),'time_format_string')

ArgumentoObrigatório?Tipo de dadosDescriçã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 de Inteiro que representa o valor do segundo a ser aplicado à função
time_format_stringSstringLiteral de string que identifica o formato de tempo a ser aplicado ao valor

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

hour_integer_col

Literal de inteiro ou nome da coluna que contém valores inteiros referentes à hora. Os valores precisam ser inteiros de 0 a 23.

  • 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)15

minute_integer_col

Literal de inteiro ou nome da coluna que contém valores inteiros referentes aos minutos. Os valores precisam ser inteiros de 0 a 59.

  • 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)23

second_integer_col

Literal de inteiro ou nome da coluna que contém valores inteiros referentes aos segundos. Os valores precisam ser inteiros de 0 a 59.

  • 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)45

time_format_string

Para mais informações sobre as strings de formatação de tempo compatíveis, 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:

anomonthdayhourminutesegundo
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.

anomonthdayhourminutesegundofctn_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.