date_add-functie

  • Artikel

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

Voegt value en unit aan een tijdstempel exprtoe. Deze functie is een synoniem voor de functie timestampadd.

Syntaxis

date_add(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 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