Функция 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()))
Связанные темы
-
Reference
-
Основные понятия