DATEADD (SSIS)
在日期的指定之日期部份加上代表日期或時間間隔的數字之後，傳回新的 DT_DBTIMESTAMP 值。number 參數必須評估為整數，date 參數必須評估為有效的日期。
語法
DATEADD(datepart, number, date)
引數
datepart
是指定要加入數字之日期部份的參數。
number
datepart 的遞增值。值必須是剖析運算式時已知的整數值。
date
傳回有效日期或日期格式字串的運算式。
結果類型
DT_DBTIMESTAMP
備註
下表列出運算式評估工具所辨識的日期部份與縮寫。日期部份的名稱不區分大小寫。
| DATEPART | 縮寫 |
|---|---|
Year |
yy, yyyy |
Quarter |
qq, q |
Month |
mm, m |
Dayofyear |
dy, y |
Day |
dd, d |
Week |
wk, ww |
Weekday |
dw, w |
Hour |
Hh |
Minute |
mi, n |
Second |
ss, s |
Millisecond |
Ms |
number 引數必須在剖析運算式時提供。這個引數可以是常數或變數。您不可使用資料行的值，因為這些值在剖析運算式時並非已知。
datepart 引數必須加上引號。
日期常值必須明確轉換為日期資料類型之一。
如果引數為 Null，則 DATEADD 會傳回 Null 結果。
如果日期無效、日期或時間單位不是字串，或累加不是靜態整數，則會發生錯誤。
範例
此範例會對目前日期加上一個月。
DATEADD("Month", 1,GETDATE())
此範例會對 ModifiedDate 資料行中的日期加上 21 天。
DATEADD("day", 21, ModifiedDate)
此範例會對常值日期加上 2 年。
DATEADD("yyyy", 2, (DT_DBTIMESTAMP)"8/6/2003")
請參閱
參考
DATEDIFF (SSIS)
DATEPART (SSIS)
DAY (SSIS)
MONTH (SSIS)
YEAR (SSIS)