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
:一个数值表达式,其中包含要添加到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