Fonction date_add

  • Article

S’applique à :coche marquée oui Databricks SQL case marquée oui Databricks Runtime 13.3 LTS et versions ultérieures

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

Syntaxe

date_add(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 du 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 date_add(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 date_add(MONTH, -1, TIMESTAMP'2022-03-31 00:00:00');
 2022-02-28 00:00:00.000000