Возвращает вариант (Date), содержащий добавленную дату с указанным интервалом времени.
Синтаксис
DateAdd(interval, number, date)
Функция DateAdd содержит следующие аргументы:
| Аргумент | Описание |
|---|---|
interval |
— обязательный аргумент. Строковое выражение, представляющее собой интервал времени, который необходимо добавить. |
number |
— обязательный аргумент. Числовое выражение, то есть количество интервалов, добавляемых к сумме. Получение дат в будущем может быть положительным, а свидание в прошлом — отрицательным. |
date |
— обязательный аргумент. Вариант (дата) или литерал, представляющий дату добавления интервала. |
Параметры
Аргумент interval имеет следующие параметры:
| Параметр | Описание |
|---|---|
yyyy |
Год |
q |
Квартал |
m |
Месяцы |
y |
День года |
d |
День |
w |
Weekday |
ww |
Неделя |
h |
Часы |
n |
Минута |
s |
Секунды |
Замечания
С помощью этой DateAdd функции можно вычитать или вычитать из даты указанный интервал времени. Например, вы можете DateAdd вычислить дату, отстоящую от сегодняшней даты через 30 дней, или время через 45 минут.
Чтобы добавить дни в date, можно использовать команды "День года" ("y"), "День" ("d") или "Деньнед" ("w").
Функция DateAdd не возвращает недопустимую дату. В следующем примере к 31 января прибавляется 1 месяц:
DateAdd("m", 1, "31-Jan-95")
В этом случае DateAdd возвращается 28 февраля 95 г., а не 31 февраля 95 г. Если date значение 31 января 96 г., возвращается 29 февраля 96 г., так как 1996 год високосный.
Если вычисленная дата предшествует 100 году, то есть вычитается больше лет, чем в date, возникает ошибка.
Если number значение не является длинным, Access округляет его до ближайшего целого числа, прежде чем вычислять выражение.
Примечание
Формат возвращаемого значения DateAdd определяется параметрами панели управления, а не форматом, передаваемым в аргументеdate.
Примечание
Для date, если свойство Calendar задано значением "Григорианский", указанная дата должна быть григорианской. Если используется календарь Хиджра, дата должна соответствовать ему. Если значения месяца являются именами, имя должно соответствовать текущему Calendar параметру свойства. Чтобы уменьшить вероятность конфликтов, вводите числовые значения месяцев в кратком формате даты.
Примеры запросов
| Выражение | Результаты |
|---|---|
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 см. в справочнике по Access VBA.
В этом примере в качестве входных данных используется 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