Поделиться через

Функция DATEADD

  • Статья

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

Синтаксис

DATEADD (DateTimeUnits, OffsetValue, DateTime)

Аргументы

DateTimeUnits

Задает единицы параметра DateTime: YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE или SECOND. Это значение учитывает регистр, и кавычки не требуются для параметра.

OffsetValue

Указывает смещение времени в единицах, указанных параметром DateTimeUnits. OffsetValue должно быть отрицательным целым числом. Положительные значения не поддерживаются.

DateTime

Указывает метку времени, из которой вычисляется смещение. Это не может быть литералом даты. Он должен быть либо GETGMTDATE, либо результатом другой функции DATEADD.

Замечания

Функция DATEADD может использоваться только в сравнениях литеральных значений и только в правой части оператора сравнения.

Функция GETGMTDATE возвращает текущую дату и время в среднем времени Гринвича (GMT). Помните, что это значение может не совпадать с локальным временем компьютера.

Не используйте оператор сравнения equals (=), так как внутреннее представление времени может создавать ошибки округления, которые приводят к непредвиденным результатам сопоставления.

Для объединения единиц смещения можно использовать несколько функций DATEADD.

Примеры

В следующем примере предложение WHERE соответствует документам, которые были изменены за последние пять дней:

...WHERE System.DateModified <=DATEADD (DAY, -5, GETGMTDATE())

В следующем примере предложение WHERE соответствует документам, которые были изменены за последние два дня и четыре часа:

...WHERE System.DateModified <=DATEADD (DAY, -2, DATEADD (HOUR, -4, GETGMTDATE()))

Справочник

сравнение литеральных значений

сравнения с несколькими значениями (ARRAY)

концептуальные

Full-Text предикаты

предика ты, отличные отFull-Text