timestampadd-functie

  • Artikel

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

Voegt valueunits toe aan een tijdstempel expr.

Syntaxis

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