共用方式為

dateadd函式

  • 發行項

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

將 s 加入valueunit至時間戳記。 expr 此函式與 timestampadd 函式同義。

語法

dateadd(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 dateadd(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 dateadd(MONTH, -1, TIMESTAMP'2022-03-31 00:00:00');
 2022-02-28 00:00:00.000000