Export (0) Print
Expand All

DATEADD (SSIS Expressions)

Returns a new DT_DBTIMESTAMP value after adding a number that represents a date or time interval to the specified datepart in a date. The number parameter must evaluate to an integer, and the date parameter must evaluate to a valid date.


DATEADD(datepart, number, date)

datepart

Is the parameter that specifies which part of the date to add a number to.

number

Is the value used to increment datepart. The value must be an integer value that is known when the expression is parsed.

date

Is an expression that returns a valid date or a string in date format.

DT_DBTIMESTAMP

The following table lists the dateparts and abbreviations recognized by the expression evaluator. Datepart names are not case sensitive.

Datepart

Abbreviations

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

The number argument must be available when the expression is parsed. The argument can be a constant or a variable. You cannot use column values because the values are not known when the expression is parsed.

The datepart argument must be enclosed by quotation marks.

A date literal must be explicitly cast to one of the date data types. For more information, see Integration Services Data Types.

NoteNote

The expression fails to validate when a date literal is explicitly cast to one of these date data types: DT_DBTIMESTAMPOFFSET, DT_DBTIMESTAMP2, and DT_DBTIME2.

DATEADD returns a null result if the argument is null.

Errors occur if a date is invalid, if the date or time unit is not a string, or if the increment is not a static integer.

This example adds one month to the current date.

DATEADD("Month", 1,GETDATE())

This example adds 21 days to the dates in the ModifiedDate column.

DATEADD("day", 21, ModifiedDate)

This example adds 2 years to a literal date.

DATEADD("yyyy", 2, (DT_DBTIMESTAMP)"8/6/2003")
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft