Повертає значення типу Variant (Date), яке містить дату з указаним доданим інтервалом часу.
Синтаксис
DateAdd(interval, number, date)
Функція DateAdd має такі аргументи:
| Аргумент | Опис |
|---|---|
interval |
— обов’язковий аргумент. Рядковий вираз, який є інтервалом часу, який потрібно додати. |
number |
— обов’язковий аргумент. Числовий вираз, який є кількістю інтервалів, які потрібно додати. Це може бути додатне значення, щоб отримати дати в майбутньому або від'ємні, щоб отримати дати в минулому. |
date |
— обов’язковий аргумент. Variant (Date) або literal that represents the date to which the interval is added. |
Параметри
Аргумент 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 лютого-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 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