Функция DateAdd

Возвращает значение типа Variant (Date), содержащее результат прибавления к дате указанного интервала времени.

Синтаксис

DateAdd ( интервал, число, дата )

Функция DateAdd имеет следующие аргументы:

Аргумент

Описание

интервал

Обязательный аргумент. Строковое выражение, обозначающее интервал времени, который требуется прибавить.

число

Обязательный аргумент. Числовое выражение, обозначающее количество интервалов, которые требуется прибавить. Может принимать положительное (для получения будущих дат) или отрицательное (для получения прошедших дат) значение.

дата

Обязательный аргумент. Значение типа Variant (Date) или литерал, представляющие дату, к которой добавляется интервал.


Совет : В Access 2010 построитель выражений включает функцию IntelliSense, которая указывает требуемые аргументы. 

Параметры

Аргумент интерваларгумент имеет следующие значения:

Параметр

Описание

yyyy

Год

q

Квартал

m

Месяц

y

День года

d

День

w

День недели

ww

Неделя

h

Часы

n

Минуты

s

Секунды


Замечания

Функция DateAdd используется для добавления указанного интервала времени к дате или его вычитания из него. Например, функцию DateAdd можно применять, чтобы вычислить дату, отстоящую на 30 дней от сегодняшнего дня, или время через 45 минут.

Чтобы добавить дни к дате, используйте значения "День года" ("y"), "День" ("d") или "День недели" ("w").

Функция DateAdd всегда возвращает допустимую дату. В следующем примере к 31 января прибавляется 1 месяц:

DateAdd("m", 1, "31-Jan-95")

В данном случае DateAdd возвращает 28-фев-95, а не 31-фев-95. Если дата имеет значение 31-янв-96, возвращаемым значением будет 29-фев-96, поскольку 1996 год — високосный.

Если вычисляемая дата предшествует 100 году (т. е. вычитается больше лет, чем указано в аргументе дата), возникает ошибка.

Если число не является значением типа Long, оно округляется до ближайшего целого числа перед вычислением.

Примечание :  Формат возвращаемого значения для функции DateAdd определяется параметрами панели управления, а не форматом, передаваемым в аргументе дата.

Примечание :  Если в свойстве Calendar задан григорианский календарь, аргумент дата следует указывать соответствующим образом. Если используется календарь Хиджра, дата должна соответствовать ему. Если значением месяца является название, оно должно соответствовать текущим параметрам свойства Calendar. Чтобы уменьшить вероятность несоответствия названий месяцев текущим параметрам свойства Calendar, вводите числовые значения месяцев (используйте краткий формат даты).

Пример

Примечание : В примерах ниже показано, как использовать эту функцию в модуле Visual Basic для приложений (VBA). Чтобы получить дополнительные сведения о работе с 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
Совершенствование навыков
Перейти к обучению
Первоочередный доступ к новым возможностям
Присоединиться к программе предварительной оценки Office

Были ли сведения полезными?

Спасибо за ваш отзыв!

Благодарим за отзыв! Возможно, будет полезно связать вас с одним из наших специалистов службы поддержки Office.

×