DATEADD (выражение SSIS)

Область применения:SQL Server среда выполнения интеграции SSIS в Фабрика данных Azure

Возвращает новое значение DT_DBTIMESTAMP после добавления числа, представляющего дату или интервал времени, к указанной части даты. Числовой параметр должен выражаться целым числом, а параметр даты — допустимой датой.

Синтаксис

  
DATEADD(datepart, number, date)

Аргументы

datepart
Параметр, задающий, к какому разделу даты следует прибавить число.

число
Значение, используемое для увеличения datepart. Оно должно быть целочисленным, т.е. известным при синтаксическом анализе выражения.

дата
Выражение, возвращающее допустимую дату или строку в формате даты.

Типы результата

DT_DBTIMESTAMP

Замечания

В следующей таблице перечислены части дат и сокращения, распознаваемые средством оценки выражений. Имена частей даты не чувствительны к регистру.

часть_даты	Сокращения
Год	yy, yyy
Квартал	qq, q
месяц	мм, м
День года	dy, y
день	dd, d
неделя	wk, ww
Будний день	ДВ, В
Час	Hh
Минута	Ми, Н
Секунда	ss, s
Миллисекунда	Г-жа

Аргумент 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")

Last updated on 2026-08-24