Partilhar via

Função date_trunc

  • Artigo

Aplica-se a: Marque Sim Databricks SQL Marque Sim Databricks Runtime

Retorna o carimbo de data/hora truncado para a unidade especificada em unit.

Sintaxe

date_trunc(unit, expr)

Argumentos

  • unit: Um STRING literal.
  • expr: A DATE, TIMESTAMPou STRING com um formato de carimbo de data/hora válido.

Devoluções

A TIMESTAMP.

Notas

Unidades válidas para unit são (sem distinção entre maiúsculas e minúsculas):

  • 'YEAR', 'YYYY', 'YY': truncar para a primeira data do ano em que as expr quedas entram, a parte do tempo será zero para fora
  • 'QUARTER': truncar para a primeira data do trimestre em que as expr quedas, a parte do tempo será zero out
  • 'MONTH', 'MM', 'MON': truncar para a primeira data do mês em que as expr quedas entram, a parte do tempo será zero para fora
  • 'WEEK': truncar para a segunda-feira da semana em que as expr quedas entram, a parte do tempo será zero out
  • 'DAY', 'DD': zerar a parte do tempo
  • 'HOUR': zerar o minuto e o segundo com parte fracionária
  • 'MINUTE': zerar o segundo com parte fracionária
  • 'SECOND': zerar a segunda parte da fração
  • 'MILLISECOND': zerar os microssegundos
  • 'MICROSECOND': tudo resta

Se o não estiver bem formado, unit a função retorna NULL.

Exemplos

> SELECT date_trunc('YEAR', '2015-03-05T09:32:05.359');
 2015-01-01 00:00:00

> SELECT date_trunc('MM', '2015-03-05T09:32:05.359');
 2015-03-01 00:00:00

> SELECT date_trunc('DD', '2015-03-05T09:32:05.359');
 2015-03-05 00:00:00

> SELECT date_trunc('HOUR', '2015-03-05T09:32:05.359');
 2015-03-05 09:00:00

> SELECT date_trunc('MILLISECOND', '2015-03-05T09:32:05.123456');
 2015-03-05 09:32:05.123

-- Not a recognised unit
> SELECT date_trunc('MS', '2015-03-05T09:32:05.123456');
 NULL