Partager via


Fonction trunc

S’applique à : case marquée oui Databricks SQL case marquée oui Databricks Runtime

Retourne une date tronquée à l’unité spécifiée par le modèle de format unit.

Syntaxe

trunc(expr, unit)

Arguments

  • expr : expression de type DATE.
  • unit : expression de type STRING spécifiant le mode de troncation.

Retours

Une DATE.

Notes

fmt doit être l’un des éléments suivants (insensible à la casse) :

  • 'YEAR', 'YYYY', 'YY' - tronque à la première date de l’année à laquelle la date se trouve.
  • 'QUARTER' - tronque à la première date du trimestre à laquelle la date se trouve.
  • 'MONTH', 'MM', 'MON' - tronque à la première date du mois à laquelle la date se trouve.
  • 'WEEK' - tronque au lundi de la semaine où la date se trouve.

Si la valeur fmt n’est pas bien formée, la fonction retourne NULL.

Exemples

> 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