Egy dátumvariantot (dátumot) ad eredményül, amely megadott időintervallumot tartalmazó dátumot tartalmaz.
Szintaxis
DateAdd(interval, number, date)
A DateAdd függvény argumentumai a következők:
| argumentumok | Leírás |
|---|---|
interval |
Kötelező megadni. A hozzáadni kívánt időtartományt tartalmazó karakterlánc. |
number |
Kötelező megadni. Numerikus kifejezés, mely a hozzáadni kívánt időtartományok számát jelenti. Pozitívan jelenhet meg jövőbeli dátumok, negatív lehet a múltbeli dátumok megjelenítése. |
date |
Kötelező megadni. Variant (dátum) vagy literál, amely azt a dátumot jelenti, amelyhez az időtartományt hozzáadja. |
Beállítások
Az interval argumentum beállításai a következők:
| Beállítás | Leírás |
|---|---|
yyyy |
Év |
q |
Negyedév |
m |
Hónap |
y |
Év napja |
d |
Nap |
w |
Hétköznap |
ww |
Hét |
h |
Óra |
n |
Perc |
s |
Másodperc |
Megjegyzések
A DateAdd függvény segítségével hozzáadhat egy adott időintervallumot, vagy kivonhatja azt egy dátumból. Kiszámítható DateAdd például a mai naptól 30 nappal későbbi vagy a 45 percre eső időpont.
Ha napokat szeretne hozzáadni a , datehasználhatja az Év napja ("y"), a Nap ("d") vagy a Hétköznap ()"w" karaktereket.
A DateAdd függvény nem ad vissza érvénytelen dátumot. A következő példa egy hónapot ad hozzá a január 31-hez:
DateAdd("m", 1, "31-Jan-95")
Ebben az esetben a DateAdd 28-Feb-95 értéket adja vissza, nem 31-Feb-95-öt. Ha date 96. január 31., akkor 96. február 29. jelenik meg, mert 1996 szökőév.
Ha a kiszámított dátum megelőzné a 100. évet, ami azt jelenti, hogy több évet von ki, mint amennyi az évben dateszerepel, hiba történik.
Ha nem hosszú értékről van number szó, akkor az Access a legközelebbi egész számra kerekíti, mielőtt kiértékelné a kifejezést.
Megjegyzés
Az argumentumban DateAdd visszatért érték formátumát nem az argumentumban date átadott formátum, hanem a Vezérlőpult beállításai határozzák meg.
Megjegyzés
Ha datea tulajdonság beállítása Calendar Gergely-naptár szerint, a megadott dátumnak Gergely-naptár szerintinek kell lennie. Iszlám naptár használata esetén a megadott dátumnak az iszlám naptár szerintinek kell lennie. Ha a hónapértékek nevek, a névnek meg kell egyeznie az aktuális Calendar tulajdonságbeállítással. Az ütközések esélyének csökkentése érdekében a hónapértékeket rövid dátumformátumban adja meg.
Példák lekérdezésekre
| Expression (Kifejezés) | Eredmény: |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
A mezőben szereplő dátumértékekhez DateofSale hozzáad 1 évet. |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
A mezőben lévő dátumértékekből DateofSale kivon 1 évet. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
A mezőben szereplő dátumértékekhez DateofSale 10 napot hozzáad, majd az oszlopban megjelenített eredményeket adja vissza NewDate . |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
A mezőben lévő dátumértékekből DateofSale kivon 1 hetet, azaz 7 napot, és az oszlopban NewDate megjelenített eredményeket adja vissza. |
VBA-példa
Megjegyzés
A következő példák egy Visual Basic for Applications (VBA) modulban mutatják be a függvény használatát. A VBA használatáról további információt az Access VBA-referenciájában talál.
Ez a példa dátumot használ bemenetként, és a DateAdd függvény segítségével megjeleníti az egyező dátumot adott számú hónappal későbbi jövőben.
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