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 引數必須加上引號。
日期常值必須明確轉換為日期資料類型之一。如需詳細資訊，請參閱＜Integration Services 資料類型＞。
[!附註]
當日期常值明確轉換成以下其中一個日期資料類型時，此運算式將會驗證失敗：DT_DBTIMESTAMPOFFSET、DT_DBTIMESTAMP2 和 DT_DBTIME2。
如果引數為 Null，則 DATEADD 會傳回 Null 結果。
如果日期無效、日期或時間單位不是字串，或累加不是靜態整數，則會發生錯誤。
範例
此範例會對目前日期加上一個月。
DATEADD("Month", 1,GETDATE())
此範例會對 ModifiedDate 資料行中的日期加上 21 天。
DATEADD("day", 21, ModifiedDate)
此範例會對常值日期加上 2 年。
DATEADD("yyyy", 2, (DT_DBTIMESTAMP)"8/6/2003")