Função trunc

Aplica-se a: SQL do Databricks Runtime do Databricks

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

Sintaxe

trunc(expr, unit)

Argumentos

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

Retornos

Um DATE.

Observações

fmt precisa ser um dos seguintes (não diferencia maiúsculas de minúsculas):

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

Se fmt não estiver bem formado, a função retornará 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