数据湖探索 DLI-时间函数:TIMESTAMPADD

时间：2024-11-16 13:21:41

数据湖探索 DLI

TIMESTAMPADD

功能描述
参考语法说明，本函数功能为将整型interval与timeintervalunit组成的结果添加到timepoint中，并返回添加后的日期时间。

TIMESTAMPADD函数返回结果与timepoint相同。例外场景为：如果timepoint输入类型为TIMESTAMP，也可以将TIMESTAMPADD函数返回结果插入到DATE类型的表字段中。

语法说明

TIMESTAMP(3)/DATE/TIME TIMESTAMPADD(timeintervalunit, interval, timepoint)

入参说明

参数名	数据类型	参数说明
timeintervalunit	TIMEUNIT	时间单位。
interval	INT	整型的时间间隔。
timepoint	TIMESTAMP/DATE/TIME	时间点

示例

测试语句

SELECT 
	TIMESTAMPADD(WEEK, 1, DATE '1997-04-25') AS `result`,
        TIMESTAMPADD(QUARTER, 1, TIMESTAMP '1997-04-25 10:11:12') AS `result2`,
	TIMESTAMPADD(SECOND, 2, TIME '10:11:12') AS `result3`
FROM	testtable;

测试结果

result	result2	result3
1997-05-02	如果该字段插入到TIMESTAMP类型的表字段中，则返回：1997-07-25T10:11:12 如果该字段插入到DATE类型的表字段中，则返回：1997-07-25	10:11:14

result

result2

result3

1997-05-02