timestampadd-Funktion

Gilt für: Databricks SQL Databricks Runtime 10.4 LTS und höher

Fügt valueuniten zu einem Zeitstempel expr hinzu.

Syntax

timestampadd(unit, value, expr)

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

Argumente

• unit: Eine Berechnungseinheit.
• value: Ein numerischer Ausdruck mit der Anzahl von uniten, die expr hinzugefügt werden sollen.
• expr: Ein TIMESTAMP-Ausdruck.

Gibt zurück

Ein TIMESTAMP-Wert.

Wenn value negativ ist, wird er von expr subtrahiert. Wenn unitMONTH, QUARTER oder YEAR ist, wird der Tagesanteil des Ergebnisses angepasst, damit es ein gültiges Datum ergibt.

Die Funktion gibt einen Überlauffehler zurück, wenn das Ergebnis über den unterstützten Zeitstempelbereich hinausgeht.

Beispiele

> 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

Zugehörige Funktionen

• add_months Funktion
• date_add-Funktion (Tage)
• date_sub Funktion
• dateadd Funktion
• timestamp Funktion