SQL DATEADD函数

语法

 

DATEADD (datepart , number , date )

 

　　将指定 number 时间间隔（有符号整数）与指定 date 的指定 datepart 相加后，返回该 date。

 

 

参数

datepart

 　　是与number 相加的 date 部分。下表列出了所有有效的 datepart 参数。用户定义的变量等效项是无效的。

　　

 

number

　　是一个表达式，可以解析为与 date 的 datepart 相加的 int。用户定义的变量是有效的。

　　如果您指定一个带小数的值，则将小数截去且不进行舍入。

date

　　是一个表达式，可以解析为 time、date、smalldatetime、datetime、datetime2 或 datetimeoffset 值。date 可以是表达式、列表达式、用户定义的变量或字符串文字。如果表达式是字符串文字，则它必须解析为一个 datetime 值。为避免不确定性，请使用四位数年份。

返回类型

　　字符串文字的返回数据类型为 datetime。如果字符串文字的秒数小数位数超过三位 (.nnn) 或包含时区偏移量部分，将引发错误。

 

返回值

 datepart 参数

　　dayofyear、day 和 weekday 返回相同的值。

　　每个 datepart 及其缩写都返回相同的值。

　　如果 datepart 为 month 且 date 月份(八月份)比返回月份(九月份)的天数多，因而 date 中的日在返回月份中不存在(九月份的31号)，则返回返回月份的最后一天。例如，9 月份有 30 天；因此，下面两个语句返回 2006-09-30 00:00:00.000：

 

SELECT DATEADD(month, 1, '2006-08-30')
SELECT DATEADD(month, 1, '2006-08-31')

 

number 参数

　　number 参数不能超出 int 的范围。在下面的语句中，number 的参数超出 int 范围 1。将返回如下错误消息：“将表达式转换为数据类型 int 时出现算术溢出错误。”

SELECT DATEADD(year,2147483648, '2006-07-31');
SELECT DATEADD(year,-2147483649, '2006-07-31');

 

date 参数

　　date 参数不能增加至其数据范围之外的值。在下面的语句中，与 date 值相加的 number 值超出了 date 数据类型的范围。将返回如下错误消息：“将值添加到 'datetime' 列导致溢出。”

SELECT DATEADD(year,2147483647, '2006-07-31');
SELECT DATEADD(year,-2147483647, '2006-07-31');