date_add
函式
適用於: Databricks SQL Databricks Runtime 13.3 LTS 和更新版本
將新增unit
value
至時間戳 。 expr
此函式與 timestampadd 函式同義。
語法
date_add(unit, value, expr)
unit
{ MICROSECOND |
MILLISECOND |
SECOND |
MINUTE |
HOUR |
DAY | DAYOFYEAR |
WEEK |
MONTH |
QUARTER |
YEAR }
引數
unit
:量值單位。value
:要加入 的expr
數值運算式,其數目unit
為 。expr
:TIMESTAMP 運算式。
傳回
時間戳。
如果 value
為負數,則會從 expr
減去 。
如果 unit
為 MONTH
, QUARTER
則為 ,或 YEAR
結果的日期部分將會調整為產生有效的日期。
如果結果超出支援的時間戳範圍,函式會傳回溢位錯誤。
範例
> 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