ADDDATE

📄字数 1.5K

👁️阅读量 加载中...

功能描述

在日期或时间值上增加时间间隔（如天数、小时、分钟等）。

语法格式

ADDDATE(expr1, INTERVAL expr2 unit)
ADDDATE(expr1, expr3)

输入参数

• expr1：日期或时间值，DATE、TIME、DATETIME、TIME WITH TIME ZONE 或 DATETIME WITH TIME ZONE 类型，或能隐式转换为上述类型的其他类型。
• expr2：增加的时间间隔值，INTERVAL unit 是时间间隔类型中的关键字，其中 unit 表示时间间隔的单位，INTERVAL unit 参数的信息，包括 unit 单位的完整列表，请参考 时间间隔类型。值可以为负数，表示减去的时间间隔。当以 INTERVAL 形式传入第二个参数时，ADDDATE() 函数和 DATE_ADD() 函数相等。
• expr3：增加的天数，INTEGER 类型，或能隐式转换为 INTEGER 类型的其他类型。

提示

• 因 NULL 无具体的类型，所以当任意参数为 NULL 时，可能会产生异常 E10100 候选函数出现多义性，需要手动为参数指定具体的类型，如：ADDDATE('2025-10-30', NULL::INTERVAL DAY)。
• expr1 为动态参数（如预编译语句参数）或字符串类型（VARCHAR）时，服务端自动匹配参数类型，可使用 CAST() 将 expr1 转换为期望的类型，如：ADDDATE(CAST('2025-10-10' AS DATE), 1)。
• SELECT ADDDATE(expr1, expr3) 的结果等价于 SELECT ADDDATE(expr1, INTERVAL expr3 DAY)。

输出结果

输出结果类型由输入参数类型决定，任意输入参数为 NULL 时，输出结果为 NULL。

输出结果和输入参数的对应关系如下：

第一个参数的类型	第二个参数的类型（unit关键字）	输出结果
DATE	DAY	DATE
DATE	MONTH	DATE
DATE	YEAR	DATE
DATE	[注1]	DATETIME
DATE	INTEGER[注2]	DATE
TIME/TIME WITH TIME ZONE	SECOND	TIME/TIME WITH TIME ZONE
TIME/TIME WITH TIME ZONE	MINUTE	TIME/TIME WITH TIME ZONE
TIME/TIME WITH TIME ZONE	HOUR	TIME/TIME WITH TIME ZONE
TIME/TIME WITH TIME ZONE	DAY	TIME/TIME WITH TIME ZONE
DATETIME/DATETIME WITH TIME ZONE	[注3]	DATETIME/DATETIME WITH TIME ZONE

提示

• [注1] 表示包含 DAY、MONTH 和 YEAR 关键字外的其他 INTERVAL 类型。
• [注2] 不是 INTERVAL unit 类型的关键字，只表示一个 INTEGER 类型。ADDDATE(expr1, INTEGER) 的结果等价于 ADDDATE(expr1, INTERVAL INTEGER DAY)。
• [注3] 表示任意 INTERVAL 类型。

示例

-- 在'2020-12-31 23:59:59'时间上增加 1 秒
SQL> SELECT ADDDATE('2020-12-31 23:59:59', INTERVAL '1' SECOND);

+--------------------------+
|          EXPR1           |
+--------------------------+
| 2021-01-01 00:00:00.000  |
+--------------------------+

-- 在'2018-12-31'时间上增加 10 天
SQL> SELECT ADDDATE('2018-12-31', INTERVAL '10' DAY);

+--------------------------+
|          EXPR1           |
+--------------------------+
| 2019-01-10 00:00:00.000  |
+--------------------------+

-- 在'2018-12-31'时间上增加 10 天
SQL> SELECT ADDDATE('2018-12-31', '10');

+-------------+
|    EXPR1    |
+-------------+
| 2019-01-10  |
+-------------+

-- 在'2010-12-31 23:59:59'时间上增加 1 分 1 秒
SQL> SELECT ADDDATE('2010-12-31 23:59:59', INTERVAL '1:1' MINUTE TO SECOND);

+--------------------------+
|          EXPR1           |
+--------------------------+
| 2011-01-01 00:01:00.000  |
+--------------------------+