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