dateadd-Funktion

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

Fügt mehrere Instanzen von valueunit zu einem Zeitstempelausdruck (expr) hinzu. Diese Funktion ist ein Synonym für timestampadd Funktion.

Syntax

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

Zugehörige Funktionen

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