Freigeben über

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

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