将表示日期或时间间隔的数值与日期中指定的日期部分相加后,返回一个新的 DT_DBTIMESTAMP 值。 number 参数的值必须为整数,而 date 参数的取值必须为有效日期。
语法
DATEADD(datepart, number, date)
论据
datepart
指定要与数值相加的日期部分的参数。
数字
用于与 datepart 相加的值。 该值必须是分析表达式时已知的整数值。
日期
返回有效日期或日期格式的字符串的表达式。
结果类型
DT_数据库时间戳
注解
下表列出了表达式计算器可以识别的日期部分和缩写形式。 日期部分名称不区分大小写。
datepart | 缩写形式 |
---|---|
年份 | yy、yyy |
季度 | qq、q |
月份 | mm、m |
年日数 | dy,y |
日期 | dd、d |
周 | wk、ww |
工作日 | dw、w |
小时 | Hh |
分钟 | mi、 n |
第二个 | ss、s |
毫秒 | 女士 |
分拆表达式时必须提供 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 表达式)