DATEADD (SSIS Expression)

Article
02/28/2023

Applies to: SQL Server SSIS Integration Runtime in Azure Data Factory

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.

Syntax

  
DATEADD(datepart, number, date)

Arguments

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.

Result Types

DT_DBTIMESTAMP

Remarks

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.

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.

SSIS Expression Examples

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