#DATE_ADD

语法图

代码

date_add

DATE_ADD函数用于执行日期运算，对expr的值按给定的区间值将时间前进或者后退。

expr

通用表达式，expr的值须为DATE、TIME、TIMESTAMP类型，或可以转换为DATE、TIMESTAMP类型的字符类型。

当expr为字面量时，只能为DATE和TMIESTAMP关键字的输入字符串，不能为TIME关键字的输入字符串。例如，DATE '2012-10-12'、TIMESTAMP '2012-10-12 10:20:24.000006'为函数可接受的expr值，而当expr为TIME '10:20:24'时函数则返回错误。

当expr为NULL时，函数返回NULL。

interval_value

指定时间前进或后退的区间值，该值不可为NULL，且必须为如下形式：

0或正整数字面量，如0、1、2等。
包含0或正整数内容的字符串字面量，如'0'、'1'、'-2'等。
包含负整数内容的字符串字面量，如'-1'、'-2'等。
包含INTERVAL内容的字符串字面量，如'10-8'、'-8 8:10:24'等。

interval_unit

指定区间值的单位，该值不可为NULL，且必须为如下形式：

MONTH、YEAR、YEAR TO MONTH关键字（不区分大小写）：此时interval_value被转换为INTERVAL YEAR TO MONTH类型。
SECOND、MINUTE、HOUR、DAY、MINUTE TO SECOND、HOUR TO SECOND、HOUR TO MINUTE、DAY TO SECOND、DAY TO MINUTE、DAY TO HOUR关键字（不区分大小写）：此时interval_value被转换为INTERVAL DAY TO SECOND类型。

interval_value与interval_unit必须正确匹配，例如分别为2/YEAR，3/HOUR，'10-8'/YEAR TO MONTH、'-8 8:10:24'/DAY TO SECOND，否则函数返回类型转换错误。

日期运算规则

1.当interval_value为INTERVAL YEAR TO MONTH类型时，运算规则为：

先进行month的增减，再看day是否符合month的增减后的day数。
如果增减后的month的天数小于增减前的month的天数，那么增减后的day数等于增减后的month的最后一天。

2.当expr和interval_value的数据类型不相同时，函数先执行类型转换，若两个数据类型之间无法按照一定的规则进行转换，则返回类型转换错误。类型转换规则如下：

expr为DATE/TIME/TIMESTAMP类型时，函数返回expr的数据类型。
expr为CHAR/VARCHAR类型时，函数先将其能转换为DATE、TIME、TIMESTAMP数据类型中的一种，转换成功则返回转换后的数据类型，否则返回类型转换错误。
expr为TIME，interval_value为INTERVAL DAY TO SECOND类型时，超过范围将翻转，即超过24小时求余数，例如计算后的小时为25时，将其翻转为1。
expr为TIME，interval_value为INTERVAL YEAR TO MONTH类型时，函数返回类型不支持错误。

示例

SELECT DATE_ADD('2012-10-12',INTERVAL  '-1' YEAR) res FROM DUAL;
RES                                                              
---------------------------------------------------------------- 
2011-10-12 00:00:00.000000  

--interval_value为INTERVAL YEAR TO MONTH类型时
SELECT DATE_ADD('2012-10-31',INTERVAL 1 MONTH) res FROM DUAL;
RES                                                              
---------------------------------------------------------------- 
2012-11-30 00:00:00.000000  

--interval_value为INTERVAL DAY TO SECOND类型时
SELECT DATE_ADD(CAST('10:20:24' AS TIME),INTERVAL '8:10:24' HOUR TO SECOND) res FROM DUAL;
RES                  
-------------------- 
18:30:48.000000 

--小时翻转
SELECT DATE_ADD(CAST('10:20:24' AS TIME),INTERVAL '14:10:24' HOUR TO SECOND) res FROM DUAL;
RES                  
-------------------- 
00:30:48.000000