Compartilhar via

Função trunc

  • Artigo

Aplica-se a: marca de seleção positiva SQL do Databricks marca de seleção positiva 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