Az adott időtartományon belüli dátumot tartalmazó Variant (dátum) értéket ad eredményül.
Szintaxis
DateAdd(intervallum; szám; dátum)
A DateAdd függvény szintaxisa az alábbi argumentumokat foglalja tartalmazza:
| argumentumok | Leírás |
|---|---|
| intervallum | Kötelező megadni. Sztringkifejezés, amely a hozzáadni kívánt időintervallum. |
| Szám | Megadása kötelező. Numerikus kifejezés, amely a hozzáadni kívánt intervallumok száma. Lehet pozitív (jövőbeli dátumok) vagy negatív (múltbeli dátumok). |
| Dátum | Kötelező megadni. Variant (Dátum) vagy konstans, amely az intervallum hozzáadásának dátumát jelöli. |
Beállítások
Az intervallumargumentum a következő beállításokat tartalmazza:
| 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énnyel megadhat vagy kivonhat egy adott időintervallumot egy dátumból. A DateAdd függvény használatával például kiszámíthat egy dátumot a mai naptól számított 30 napból vagy egy 45 perces időből.
A napok dátumhoz való hozzáadásához használhatja az év napját ("y"), a napot ("d") vagy a hétköznapot ("w").
A DateAdd függvény nem ad vissza érvénytelen dátumot. Az alábbi példa egy hónapot ad hozzá január 31-hez:
DateAdd("m", 1, "31-Jan-95")
Ebben az esetben a DateAdd a 28-feb-95 értéket adja vissza, nem a 31-feb-95 értéket. Ha a dátum január 31-96, akkor február 29-96-ot ad vissza, mivel az 1996 szökőév.
Ha a számított dátum megelőzné a 100. évet (azaz több évet vonna ki, mint a dátum), hiba történik.
Ha a szám nem Hosszú érték, a kiértékelés előtt a függvény a legközelebbi egész számra kerekítve lesz.
Megjegyzés
A DateAdd visszatérési értékének formátumát Vezérlőpult beállítások határozzák meg, nem pedig a dátum argumentumban átadott formátum alapján.
Megjegyzés
Dátum esetén, ha a Calendar tulajdonság értéke Gergely-naptár, 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 konzisztensnek kell lennie az aktuális Calendar tulajdonságbeállítással. Ha minimálisra szeretné csökkenteni annak lehetőségét, hogy a hónapnevek ütköznek az aktuális Calendar tulajdonságbeállítással, adjon meg numerikus hónapértékeket (Rövid dátum formátum).
Példák lekérdezésre
| Kifejezés | Eredmény: |
|---|---|
| SELECT DateAdd("YYYY";1,[DateofSale]) AS Expr1 FROM ProductSales; | Az eredményeket úgy adja vissza, hogy 1 évet ad hozzá a "DateofSale" mező dátumértékeihez. |
| SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; | Az eredményeket úgy adja vissza, hogy az 1 évet kivonja a "DateofSale" mező dátumértékeiből. |
| SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; | Az eredményeket a "NewDate" oszlopban adja vissza úgy, hogy 10 napot ad hozzá a "DateofSale" mező dátumértékeihez. |
| SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; | Az eredményeket a "NewDate" oszlopban adja vissza úgy, hogy kivon 1 hetet (7 napot) a "DateofSale" mező dátumértékéből. |
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ával kapcsolatos további információkért lásd: Access VBA-referencia.
Ez a példa egy dátumot vesz bemenetként, és a DateAdd függvénnyel megjelenít egy megfelelő dátumot egy megadott számú hónappal a 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