Partager via

Fonction dateadd

  • Article

S’applique à : coche marquée oui Databricks SQL oui coché Databricks Runtime 10.4 LTS et ultérieur

Ajoute value unit à un timestamp expr. Cette fonction est similaire à la fonction timestampadd.

Syntaxe

dateadd(unit, value, expr)

unit
 { MICROSECOND |
   MILLISECOND |
   SECOND |
   MINUTE |
   HOUR |
   DAY | DAYOFYEAR |
   WEEK |
   MONTH |
   QUARTER |
   YEAR }

Arguments

  • unit : unité de mesure.
  • value : expression numérique avec le nombre de unit à ajouter à expr.
  • expr : expression de type TIMESTAMP.

Retours

TIMESTAMP.

Si value est négatif, il est soustrait de expr. Si unit est MONTH, QUARTER ou YEAR, la partie jour du résultat sera ajustée pour donner une date valide.

La fonction retourne une erreur de dépassement si le résultat dépasse la plage prise en charge de timestamps.

Exemples

> SELECT dateadd(MICROSECOND, 5, TIMESTAMP'2022-02-28 00:00:00');
 2022-02-28 00:00:00.000005

-- March 31. 2022 minus 1 month yields February 28. 2022
> SELECT dateadd(MONTH, -1, TIMESTAMP'2022-03-31 00:00:00');
 2022-02-28 00:00:00.000000