DATEADD (выражение служб SSIS)
Область применения: среда выполнения интеграции SSIS SQL Server в Фабрика данных Azure
Возвращает новое значение DT_DBTIMESTAMP после добавления числа, представляющего дату или интервал времени, к указанной части даты. Числовой параметр должен выражаться целым числом, а параметр даты — допустимой датой.
Синтаксис
DATEADD(datepart, number, date)
Аргументы
datepart
Параметр, задающий, к какому разделу даты следует прибавить число.
number
Значение, используемое для увеличения datepart. Оно должно быть целочисленным, т.е. известным при синтаксическом анализе выражения.
date
Выражение, возвращающее допустимую дату или строку в формате даты.
Типы результата
DT_DBTIMESTAMP
Замечания
В следующей таблице перечислены части дат и сокращения, распознаваемые средством оценки выражений. Имена частей даты обрабатываются без учета регистра.
часть_даты | Abbreviations |
---|---|
Год | yy, yyyy |
Квартальная | qq, q |
месяц | mm, m |
День года | dy, y |
день | dd, d |
неделя | wk, ww |
Weekday | dw, w |
Часы | Hh |
Minute | mi, n |
Second | ss, s |
Миллисекунда | Ms |
Аргумент number должен быть доступен при синтаксическом анализе выражения. Он может быть константой или переменной. Нельзя использовать значения столбцов, поскольку они неизвестны при синтаксическом анализе выражения.
Аргумент datepart необходимо заключать в кавычки.
Литерал даты должен быть явно приведен к одному из типов данных даты. Дополнительные сведения см. в разделе Integration Services Data Types.
Функция DATEADD возвращает результат NULL, если значением аргумента является NULL.
Ошибки возникают в тех случаях, когда дата недопустима, единица даты и времени не является строкой или приращение не является статическим целым числом.
Примеры выражений служб SSIS
В этом примере добавляется один месяц к текущей дате.
DATEADD("Month", 1,GETDATE())
В этом примере добавляется 21 день к датам в столбце ModifiedDate .
DATEADD("day", 21, ModifiedDate)
В этом примере добавляются два года к литеральной дате.
DATEADD("yyyy", 2, (DT_DBTIMESTAMP)"8/6/2003")
См. также
DATEDIFF (выражение служб SSIS)
DATEPART (выражение служб SSIS)
DAY (выражение служб SSIS)
MONTH (выражение служб SSIS)
YEAR (выражение служб SSIS)
Функции (выражение служб SSIS)