timestampadd 函数

  • 项目

适用于：check marked yes Databricks SQL check marked yes Databricks Runtime 10.4 及更高版本

将 valueunit 添加到时间戳 expr。

语法

timestampadd(unit, value, expr)

unit
 { MICROSECOND |
   MILLISECOND |
   SECOND |
   MINUTE |
   HOUR |
   DAY | DAYOFYEAR |
   WEEK |
   MONTH |
   QUARTER |
   YEAR }

参数

  • unit：度量单位。
  • value：一个数值表达式，其中包含要添加到 expr 的 unit 的数目。
  • expr：时间戳表达式。

返回

一个时间戳。

如果 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