Повертає значення типу Variant (Date), яке містить дату для якої було додано вказаний часовий інтервал.
Синтаксис
DateAdd ( інтервал;число;дата )
Синтаксис функції DateAdd має такі аргументи:
|
Аргумент |
Опис |
|---|---|
|
interval |
Обов’язковий аргумент. Рядковий вираз, який є інтервалом часу, який потрібно додати. |
|
number |
Обов’язковий аргумент. Числовий вираз, який є кількістю інтервалів, які потрібно додати. Він може бути додатним (для отримання дат у майбутньому) або від’ємним (для отримання дат у минулому). |
|
date |
— обов’язковий аргумент. Variant (Date) або literal representing date to which the interval is added. |
Параметри
Інтерваларгумент має такі настройки:
|
Параметр |
Опис |
|---|---|
|
yyyy |
Рік |
|
q |
Квартал |
|
m |
Місяць |
|
y |
День року |
|
d |
День |
|
w |
День тижня |
|
ww |
Тиждень |
|
h |
Година |
|
n |
Хвилина |
|
s |
Секунда |
Примітки
За допомогою функції DateAdd можна додати або відняти вказаний часовий інтервал від дати. Наприклад, за допомогою функції DateAdd можна обчислити дату за 30 днів від сьогоднішнього дня або час, який минає через 45 хвилин.
Щоб додати дні до дати, можна скористатися днем року ("y"), днем ("d" або днем тижня ("ж").
Функція DateAdd не поверне неприпустиму дату. У наведеному нижче прикладі до 31 січня додається один місяць:
DateAdd("m", 1, "31-Jan-95")
У цьому випадку DateAdd повертає 28 лютого-95, а не 31 лютого-95. Якщо дата 31 січня-96, вона повертає 29 лютого-96, тому що 1996 рік високосний.
Якщо обчислювана дата передує 100 року (тобто віднімається більше років, ніж на сьогоднішній день), стається помилка.
Якщо аргумент «число » – не довге значення, округлюється до найближчого цілого числа перед обчисленням.
Примітка.: Формат значення, що повертається для DateAdd , визначається параметрами Панелі керування , а не форматом, переданим в аргументі дата .
Примітка.: Для дати, якщо властивість Calendar має значення Gregorian, указана дата має бути григоріанським календарем. Якщо це календар хіджри, отримана дата відповідатиме цьому календарю. Якщо значення місяця – це імена, ім'я має відповідати поточній властивості Календаря . Щоб мінімізувати можливість відображення назв місяців, що конфліктують із поточним параметром властивості Calendar , введіть числові значення місяця (короткий формат дати).
Приклади запитів
|
Вираз |
Результати |
|---|---|
|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Вираз1 FROM ProductSales; |
Повертає результати, додаючи 1 рік до значень дати поля "DateofSale". |
|
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Вираз1 FROM ProductSales; |
Повертає результати, віднімаючи 1 рік до значень дати поля "Дата_продажу". |
|
SELECT DateAdd("d",10;[DateofSale]) AS NewDate FROM ProductSales; |
Повертає результати у стовпці "NewDate", додаючи 10 днів до значень дати поля "DateofSale". |
|
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Повертає результати у стовпці "NewDate", віднімаючи 1 тиждень (7 днів) від значень дати поля "Дата_продажу". |
Приклад VBA
Примітка.: У прикладах нижче показано використання цієї функції в модулі Visual Basic for Applications (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
