Sdílet prostřednictvím

Funkce date_add

  • Článek

Platí pro: zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 13.3 LTS a vyšší

Přidá value časové razítko a unit do časového razítka expr. Tato funkce je synonymem pro funkci timestampadd.

Syntaxe

date_add(unit, value, expr)

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

Argumenty

  • unit: Měrná jednotka.
  • value: Číselný výraz s počtem units přičítávaným znakem expr.
  • expr: Výraz TIMESTAMP.

Návraty

ČASOVÉ RAZÍTKO.

Pokud value je záporná, odečte se od exprhodnoty . Pokud unit je MONTHhodnota , QUARTERnebo YEAR denní část výsledku bude upravena tak, aby byla výsledkem platné datum.

Funkce vrátí chybu přetečení, pokud výsledek přesahuje podporovaný rozsah časových razítek.

Příklady

> 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