DATEADD (SSIS 運算式)

  • 發行項

適用於：SQL Server Azure Data Factory 中的 SSIS Integration Runtime

在日期的指定之日期部分加上代表日期或時間間隔的數字之後，傳回新的 DT_DBTIMESTAMP 值。 number 參數必須評估為整數，date 參數必須評估為有效的日期。

語法

  
DATEADD(datepart, number, date)

引數

datepart
是指定要加入數字之日期部份的參數。

number
這是用來遞增 datepart的值。 值必須是剖析運算式時已知的整數值。

date
傳回有效日期或日期格式字串的運算式。

結果類型

DT_DBTIMESTAMP

備註

下表列出運算式評估工具所辨識的日期部份與縮寫。 日期部份的名稱不區分大小寫。

日期部份 縮寫
Year yy, yyyy
季 qq, q
Month mm, m
Dayofyear dy, y
天 dd, d
週 wk, ww
Weekday dw, w
小時 Hh
Minute mi, n
Second ss, s
Millisecond Ms

number 引數必須在剖析運算式時提供。 這個引數可以是常數或變數。 您不可使用資料行的值，因為這些值在剖析運算式時並非已知。

datepart 引數必須加上引號。

日期常值必須明確轉換為日期資料類型之一。 如需詳細資訊，請參閱 Integration Services 資料類型。

如果引數為 Null，則 DATEADD 會傳回 Null 結果。

如果日期無效、日期或時間單位不是字串，或累加不是靜態整數，則會發生錯誤。

SSIS 運算式範例

此範例會對目前日期加上一個月。

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 運算式)
函數 (SSIS 運算式)