timestampadd 函数

适用于: 勾选“是” Databricks SQL 勾选“是” Databricks Runtime 10.4 LTS 及更高版本

value unit 添加到时间戳 expr

语法

timestampadd(unit, value, expr)

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

参数

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

返回

一个时间戳。

如果 value 为负,则从 expr 中减去它。 如果 unitMONTHQUARTERYEAR,则会调整结果的日期部分,以生成有效的日期。

如果结果超出支持的时间戳范围,则函数将返回溢出错误。

示例

> 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