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)