DATEADD（SSIS 表达式）

适用于：SQL Server Azure 数据工厂中的 SSIS Integration Runtime

将表示日期或时间间隔的数值与日期中指定的日期部分相加后，返回一个新的 DT_DBTIMESTAMP 值。 number 参数的值必须为整数，而 date 参数的取值必须为有效日期。

语法

  
DATEADD(datepart, number, date)  

参数

datepart
指定要与数值相加的日期部分的参数。

数字
用于与 datepart 相加的值。 该值必须是分析表达式时已知的整数值。

date
返回有效日期或日期格式的字符串的表达式。

结果类型

DT_DBTIMESTAMP

备注

下表列出了表达式计算器可以识别的日期部分和缩写形式。 日期部分名称不区分大小写。

datepart	缩写形式
Year	yy、yyyy
Quarter	qq、q
Month	mm、m
Dayofyear	dy、y
天	dd、d
周	wk、ww
星期	dw、w
小时	Hh
Minute	mi、n
秒	ss、s
Millisecond	Ms

分拆表达式时必须提供 number 参数。 该参数可以是常量，也可以是变量。 由于分析表达式时列值是未知的，因此不能使用列值。

datepart 参数必须用英文引号括起来。

日期文字必须显式转换为日期数据类型之一。 有关详细信息，请参阅 Integration Services 数据类型。

如果参数为空，则 DATEADD 返回空结果。

如果日期无效，日期或时间单元不是字符串，或者增量不是静态整数，则会发生错误。

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 表达式）