在向指定日期加上一段時間的基礎上,返回新的 datetime 值。
文法
DATEADD ( datepart , number, date )
參數
datepart
是規定應向日期的哪一部分返回新值的參數。下表列出了 Microsoft SQL Server 識別的日期部分和縮寫。
| 日期部分 |
縮寫 |
| Year |
yy, yyyy |
| quarter |
qq, q |
| Month |
mm, m |
| dayofyear |
dy, y |
| Day |
dd, d |
| Week |
wk, ww |
| Hour |
hh |
| minute |
mi, n |
| second |
ss, s |
| millisecond |
ms |
number
是用來增加 datepart 的值。如果指定一個不是整數的值,則將廢棄此值的小數部分。例如,如果為 datepart 指定 day,為 number 指定 1.75,則 date 將增加 1。
date
是返回 datetime 或 smalldatetime 值或日期格式字串的運算式。有關指定日期的更多資訊,請參見 datetime 和 smalldatetime。
如果您只指定年份的最後兩位元字,則小於或等於"兩位元年份截止期"配置選項的值的最後兩位元字的數字所在世紀與截止年所在世紀相同。大於該選項的值的最後兩位元字的數字所在世紀為截止年所在世紀的前一個世紀。例如,如果 two digit year cutoff 為 2049(預設),則 49 被解釋為 2049,2050 被解釋為 1950。為避免模糊,請使用四位元的年份。
傳回型別
返回 datetime,但如果 date 參數是 smalldatetime,返回 smalldatetime。
樣本
此樣本列印出 pubs 資料庫中標題的時間結構的列表。此時間結構表示當前發布日期加上 21 天。
USE pubsGOSELECT DATEADD(day, 21, pubdate) AS timeframeFROM titlesGO
下面是結果集:
timeframe---------------------------Jul 3 1991 12:00AMJun 30 1991 12:00AMJul 21 1991 12:00AMJul 13 1991 12:00AMJun 30 1991 12:00AMJul 9 1991 12:00AMMar 14 1997 5:09PMJul 21 1991 12:00AMJul 3 1994 12:00AMMar 14 1997 5:09PMNov 11 1991 12:00AMJul 6 1991 12:00AMOct 26 1991 12:00AMJul 3 1991 12:00AMJul 3 1991 12:00AMNov 11 1991 12:00AMJul 3 1991 12:00AMJul 3 1991 12:00AM(18 row(s) affected)