Повертає значення типу 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, можна використовувати такі поля, як "День року"y"", "День" ("d") або "День тижня" ("w").
Функція DateAdd не повертатиме неприпустиму дату. Приклад нижче додає один місяць до 31 січня:
DateAdd("m", 1, "31-Jan-95")
У цьому випадку DateAdd повертається 28 лютого 2095 року, а не 31 лютого 95 року. Якщо date встановлено значення 31 січня 2096 р., буде повернуто значення 29 лютого 2096 р., тому що 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 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