Delen via

dateadd-functie

  • Artikel

Van toepassing op: vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 10.4 LTS en hoger

Voegt value units toe aan een tijdstempel expr. Deze functie is een synoniem voor de functie timestampadd.

Syntaxis

dateadd(unit, value, expr)

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

Argumenten

  • unit: Een maateenheid.
  • value: Een numerieke expressie met het aantal units dat moet worden toegevoegd aan expr.
  • expr: een TIMESTAMP-expressie.

Retouren

EEN TIJDSTEMPEL.

Als value dit negatief is, wordt deze afgetrokken van de expr. Als unit dat het is MONTH, QUARTERof YEAR het daggedeelte van het resultaat, wordt aangepast om te resulteren in een geldige datum.

De functie retourneert een overloopfout als het resultaat buiten het ondersteunde bereik van tijdstempels valt.

Voorbeelden

> 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