dateadd-Funktion

  • Artikel

Gilt für:Häkchen ja Databricks SQL Häkchen gesetzt ja Databricks Runtime 10.4 LTS und höher

Fügt valueuniten zu einem Zeitstempel expr hinzu. Diese Funktion ist ein Synonym für die 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