date_add-Funktion

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

Fügt value und unit zum Zeitstempel expr hinzu. Diese Funktion ist ein Synonym für timestampadd Funktion.

Syntax

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

Zugehörige Funktionen

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