DATEADD

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

Синтаксис

DATEADD(<dates>,<number_of_intervals>,<interval>)  

Параметры

Термин Определение
даты Столбец, содержащий даты.
number_of_intervals Целое число, указывающее количество интервалов, добавляемых в даты или вычитаемых из них.
interval Интервал для сдвига дат. Значение параметра interval может быть одним из следующих: year, quarter, month, day.

Возвращаемое значение

Таблица, содержащая один столбец значений даты.

Remarks

Аргумент dates может принимать любое из следующих значений:

  • ссылка на столбец даты и времени;

  • табличное выражение, возвращающее один столбец значений даты и времени;

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

    Примечание

    Ограничения логических выражений описаны в разделе Функция CALCULATE.

  • Если число, указанное для number_of_intervals, положительное, даты в dates перемещаются вперед во времени. Если число отрицательное, даты в dates сдвигаются назад во времени.

  • Параметр interval является перечислением, а не набором строк. Поэтому значения не должны заключаться в кавычки. Кроме того, значения year, quarter, month, day должны быть записаны полностью при использовании.

  • Таблица результатов содержит только даты, которые существуют в столбце dates.

  • Если даты в текущем контексте не формируют непрерывный интервал, функция возвращает ошибку.

  • Эта функция не поддерживается для использования в режиме DirectQuery при использовании в вычисляемых столбцах или правилах безопасности на уровне строк (RLS).

Пример. Сдвиг набора дат

Следующая формула вычисляет даты на год раньше дат в текущем контексте.

= DATEADD(DateTime[DateKey],-1,year)  

См. также

Функции операций со временем
Функции даты и времени