Funktionen date_add

Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 13.3 LTS och senare

Lägger till value och unit till en tidsstämpel expr. Den här funktionen är en synonym för timestampadd funktionen.

Syntax

date_add(unit, value, expr)

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

Argument

  • unit: En måttenhet.
  • value: Ett numeriskt uttryck med antalet units som ska läggas till i expr.
  • expr: Ett TIMESTAMP-uttryck.

Returer

EN TIDSSTÄMPEL.

Om value är negativt subtraheras det från expr. Om unit är MONTH, QUARTER, eller YEAR så justeras dagsdelen av resultatet för att resultera i ett giltigt datum.

Funktionen returnerar ett spillfel om resultatet ligger utanför det tidsstämplar som stöds.

Exempel

> 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