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ő. Sztringkifejezés, amely a hozzáadni kívánt időintervallum. |
|
szám |
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 |
Megadása kötelező. Variant (Dátum) vagy konstans, amely az intervallum hozzáadásának dátumát jelöli. |
Beállítások
Az intervallum 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é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 a Vezérlőpult beállításai határozzák meg, nem pedig a dátumargumentumban átadott formátum alapján.
Megjegyzés: Dátum esetén, ha a Naptár tulajdonság értéke Gergely-naptár, a megadott dátumnak Gergely-naptárnak 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 összhangban kell lennie az aktuális Naptár 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 Naptár tulajdonságbeállítással, adjon meg numerikus hónapértékeket (Rövid dátum formátum).
Példák lekérdezésre
|
Expression |
Eredmények |
|---|---|
|
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
