Função trunc

Aplica-se a: Databricks SQL Databricks Runtime

Retorna uma data com a data truncada para a unidade especificada pelo modelo unitde formato.

Sintaxe

trunc(expr, unit)

Argumentos

• expr: Uma expressão DATE.
• unit: Uma expressão STRING que especifica como truncar.

Devoluções

UMA DATA.

Notas

fmt deve ser um dos (sem distinção entre maiúsculas e minúsculas):

• 'YEAR', 'YYYY', 'YY' - truncar até à primeira data do ano em que a data se insere.
• 'QUARTER' - truncar até à primeira data do trimestre em que a data se insere.
• 'MONTH', 'MM', 'MON' - truncar até à primeira data do mês em que a data se insere.
• 'WEEK' - truncar para a segunda-feira da semana em que a data cai.

Se fmt não estiver bem formada, a função retorna NULL.

Exemplos

> SELECT trunc('2019-08-04', 'week');
 2019-07-29

> SELECT trunc('2019-08-04', 'quarter');
 2019-07-01

> SELECT trunc('2009-02-12', 'MM');
 2009-02-01

> SELECT trunc('2015-10-27', 'YEAR');
 2015-01-01

-- 'JAHR' is not a recognized unit
> SELECT trunc('2015-10-27', 'JAHR');
 NULL

Funções relacionadas

• date_trunc função