Fonction timestampadd

  • Article

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

Ajoute valueunits à un timestamp expr.

Syntaxe

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