Връща стойност от тип Variant (Date), съдържаща дата, към която е добавен указан времеви интервал.
Синтаксис
DateAdd ( интервал; число; дата )
Синтаксисът на функцията DateAdd има следните аргументи:
|
Аргумент |
Описание |
|---|---|
|
интервал |
Задължително. Израз във формата на низ, представляващ интервала от време, който искате да добавите. |
|
число |
Задължително. Числов израз, представляващ броя интервали, които искате да добавите. Може да е положително (за дати в бъдещето) или отрицателно (за дати в миналото). |
|
дата |
Задължително. Стойност от тип Variant (Date) или литерал, представяща датата, към която се добавя интервалът. |
Настройки
Интервалът ,аргумент има следните настройки:
|
Настройка |
Описание |
|---|---|
|
yyyy |
Година |
|
q |
Тримесечие |
|
m |
Месец |
|
y |
Ден от годината |
|
d |
Ден |
|
w |
Weekday |
|
ww |
Седмица |
|
ч |
Час |
|
м |
Минута |
|
с |
Секунда |
Забележки
Можете да използвате функцията DateAdd , за да добавите или извадите зададен времеви интервал от дата. Можете например да използвате DateAdd , за да изчислите дата 30 дни след днешната дата или 45-минутен час от сега нататък.
За да добавите дни към дата, можете да използвате Ден от годината ("y"), Ден ("d") или Делничен ден ("w").
Функцията DateAdd няма да върне невалидна дата. Примерът по-долу добавя един месец към 31 януари:
DateAdd("m", 1, "31-Jan-95")
В този случай DateAdd връща 28-фев-95, а не 31-фев-95. Ако дата е 31 януари-96, връща се 29-фев-96, защото 1996 е високосна година.
Ако изчисляемата дата предшества 100-та година (т.е. изваждате повече години, отколкото са в дата), възниква грешка.
Ако числото не е стойност от тип Long, то се закръглява до най-близкото цяло число, преди да бъде изчислено.
Забележка: Форматът на върнатата стойност за DateAdd се определя от настройките на Контролен панел, а не от формата, подаден в аргумента дата.
Забележка: За дата, ако настройката на свойството Календар е Григорианска, подадената дата трябва да бъде григориански. Ако календарът е хиджри, предоставената дата трябва да бъде Хиджри. Ако стойностите за месеца са имена, името трябва да съответства на текущата настройка на свойството Календар . За да намалите възможността имената на месеците да са в конфликт с текущата настройка на свойството Календар , въведете числови стойности за месеца (формат на кратка дата).
Примери за заявки
|
Израз |
Резултати |
|---|---|
|
SELECT DateAdd("YYYY";1;[DateofSale]) AS Израз1 FROM Продажби на продукти; |
Връща резултатите, като добавя 1 година към стойностите на датата на полето "DateofSale". |
|
SELECT DateAdd("YYYY",-1;[DateofSale]) AS Израз1 FROM Продажби на продукти; |
Връща резултатите, като изважда 1 година от стойностите за дата на полето "DateofSale". |
|
SELECT DateAdd("d";10;[DateofSale]) AS NewDate FROM ProductSales; |
Връща резултатите в колона "Нова_дата", като добавя 10 дни към стойностите за дати на полето "DateofSale". |
|
SELECT DateAdd("ww",-1;[DateofSale]) AS NewDate FROM ProductSales; |
Връща резултатите в колона "Нова_дата", като изважда 1 седмица (7 дни) от стойностите на датата на полето "DateofSale". |
Пример на VBA
Забележка: Примерите по-долу илюстрират използването на тази функция във Visual Basic for Applications (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
