DATEADD(SSIS 表达式)

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

语法

DATEADD(datepart, number, date)

参数

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

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

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

结果类型

DT_DBTIMESTAMP

注释

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

日期部分

缩写形式

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 数据类型

如果参数为空,则 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 表达式)