共用方式為


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")