共用方式為


date_add函式

適用於:核取記號為「是」 Databricks SQL 核取記號為「是」 Databricks Runtime 13.3 LTS 和更新版本

將新增unitvalue至時間戳 。 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減去 。 如果 unitMONTHQUARTER則為 ,或 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