Возвращает значение Variant (Date), содержащее дату с указанным интервалом времени.
Синтаксис
DateAdd(interval, number, date)
Функция DateAdd имеет следующие аргументы:
| Аргумент | Описание |
|---|---|
interval |
— обязательный аргумент. Строковое выражение, которое представляет собой интервал времени, который требуется добавить. |
number |
— обязательный аргумент. Числовое выражение, которое представляет собой количество интервалов, которые требуется добавить. Это может быть положительным для получения дат в будущем или отрицательным, чтобы получить даты в прошлом. |
date |
— обязательный аргумент. Variant (Date) или литерал, представляющий дату, к которой добавляется интервал. |
Параметры
Аргумент interval имеет следующие параметры:
| Параметр | Описание |
|---|---|
yyyy |
Год |
q |
Квартал |
m |
Месяцы |
y |
День года |
d |
День |
w |
Weekday |
ww |
Неделя |
h |
Часы |
n |
Минута |
s |
Секунды |
Замечания
Функцию DateAdd можно использовать для добавления или вычитания указанного интервала времени из даты. Например, можно использовать для DateAdd вычисления даты 30 дней с сегодняшнего дня или времени через 45 минут.
Для добавления дней в dateможно использовать Day of Year ("y"), Day ("d") или Weekday ("w").
Функция DateAdd не возвращает недопустимую дату. В следующем примере к 31 января прибавляется 1 месяц:
DateAdd("m", 1, "31-Jan-95")
В этом случае DateAdd возвращается значение 28 февраля 95, а не 31 февраля 95. Если date это 31 января-96, он возвращается 29-февраля-96, потому что 1996 год является високосным годом.
Если вычисляемая дата будет предшествовать 100 году, то есть вычитается больше лет, чем в date, возникает ошибка.
Если number значение не является значением Long, Access округляет его до ближайшего целого числа, прежде чем вычисляет выражение.
Примечание
Формат возвращаемого значения для DateAdd определяется панель управления параметрами, а не форматом, переданным в аргументе date .
Примечание
Для date, если Calendar свойство имеет значение григорианский, указанная дата должна быть григорианской. Если используется календарь Хиджра, дата должна соответствовать ему. Если значения месяца являются именами, имя должно соответствовать текущему Calendar параметру свойства. Чтобы уменьшить вероятность возникновения конфликтов, введите числовые значения месяца в формате Short Date.
Примеры запросов
| Выражение | Результаты |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Добавляет 1 год к значениям даты в DateofSale поле . |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Вычитает 1 год из значений даты в DateofSale поле. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Добавляет 10 дней к значениям даты в DateofSale поле и возвращает результаты в столбце NewDate . |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Вычитает 1 неделю или 7 дней из значений даты в DateofSale поле и возвращает результаты в столбце NewDate . |
Пример VBA
Примечание
В примерах ниже показано, как использовать эту функцию в модуле Visual Basic для приложений (VBA). Дополнительные сведения о работе с VBA см. в справочнике по VBA access.
В этом примере в качестве входных данных используется DateAdd функция для отображения совпадающей даты с указанным числом месяцев в будущем.
Dim FirstDate As Date ' Declare variables.
Dim IntervalType As String
Dim Number As Integer
Dim Msg
IntervalType = "m" ' "m" specifies months as interval.
FirstDate = InputBox("Enter a date")
Number = InputBox("Enter number of months to add")
Msg = "New date: " & _
DateAdd(IntervalType, Number, FirstDate)
MsgBox Msg