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 参数必须用英文引号括起来。
日期文字必须显式转换为日期数据类型之一。
如果参数为空,则 DATEADD 返回空结果。
如果日期无效,日期或时间单元不是字符串,或者增量不是静态整数,则会发生错误。
示例
以下示例将当前日期加上一个月。
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)