Funktionen timestampadd
Gäller för: Databricks SQL Databricks Runtime 10.4 LTS och senare
Lägger value
unit
till s i en tidsstämpel expr
.
Syntax
timestampadd(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 antaletunit
s som ska läggas till iexpr
.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 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