Funkcja date_add

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 13.3 LTS i nowsze

Dodaje value znacznik czasu i unit do znacznika exprczasu . Ta funkcja jest synonimem funkcji timestampadd.

Składnia

date_add(unit, value, expr)

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

Argumenty

  • unit: jednostka miary.
  • value: wyrażenie liczbowe z liczbą s do dodania unitdo exprelementu .
  • expr: wyrażenie TIMESTAMP.

Zwraca

SYGNATURA CZASOWA.

Jeśli value wartość jest ujemna, jest odejmowana z obiektu expr. Jeśli unit wartość to MONTH, QUARTERlub YEAR część dnia wyniku zostanie skorygowana, aby spowodować prawidłową datę.

Funkcja zwraca błąd przepełnienia, jeśli wynik wykracza poza obsługiwany zakres sygnatur czasowych.

Przykłady

> 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