timestampadd
函式
適用於: Databricks SQL Databricks Runtime 10.4 LTS 和更新版本
將 s 加入value
unit
至時間戳記。 expr
語法
timestampadd(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 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