DATEADD (службы SSIS)
Возвращает новое значение DT_DBTIMESTAMP после добавления числа, представляющего дату или временной интервал, к указанному разделу даты. Числовой параметр должен выражаться целым числом, а параметр даты — допустимой датой.
Синтаксис
DATEADD(datepart, number, date)
Аргументы
- datepart
Параметр, задающий, к какому разделу даты следует прибавить число.
- number
Значение, используемое для увеличения datepart. Оно должно быть целочисленным, т.е. известным при синтаксическом анализе выражения.
- date
Выражение, возвращающее допустимую дату или строку в формате даты.
Типы результата
DT_DBTIMESTAMP
Замечания
В следующей таблице перечислены части дат и сокращения, распознаваемые средством оценки выражений. Имена разделов даты обрабатываются без учета регистра.
| Часть даты | Сокращения |
|---|---|
Год |
гг, гггг |
Квартал |
квкв, кв |
Месяц |
мм, м |
Dayofyear |
дг, г |
День |
дд, д |
Неделя |
нед, нн |
День недели |
дн, н |
Час |
Чч |
Минута |
мин, м |
Секунда |
сек, с |
Millisecond |
Mс |
Аргумент number должен быть доступен при синтаксическом анализе выражения. Он может быть константой или переменной. Нельзя использовать значения столбцов, поскольку они неизвестны при синтаксическом анализе выражения.
Аргумент datepart необходимо заключать в кавычки.
Литерал даты должен быть точно приведен к одному типу данных дат.
Функция DATEADD возвращает результат NULL, если значением аргумента является NULL.
Ошибки возникают в тех случаях, когда дата недопустима, единица даты и времени не является строкой или приращение не является статическим целым числом.
Примеры
В этом примере добавляется один месяц к текущей дате.
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)