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');