Dela via

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 synonym för tidsstämplar.

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