DateAdd függvény

Egy Variant (Date) típussal tér vissza. Ez olyan dátumot tartalmaz, amelyet egy időpont és egy időtartam összeadásával kaptunk meg.

A DateAdd függvény segítségével megadott időtartamot adhatunk hozzá egy dátumhoz, illetve vonhatunk ki belőle. A DateAdd függvénnyel például meghatározhatjuk a mához képest 30 nappal, vagy az aktuális pillanathoz képest 45 perccel későbbi időpontot.

Ha napokat akarunk hozzáadni egy dátumhoz, akkor az év napjai ("y"), nap ("d") vagy hét napjai ("w") paramétereket is használhatjuk.

A DateAdd függvény mindig érvényes dátumot ad vissza. Az alábbi példában egy hónapot adunk hozzá január 31-hez:

DateAdd("m", 1, "31-Jan-95")

Ebben az esetben a DateAdd visszatérési értéke 1995. február 28., és nem 1995. február 31. Ha a dátum értéke 1996. január 31., akkor visszatérési értéke 1995. február 29. lesz, ugyanis 1996 szökőév volt.

Ha az eredményül kapott dátum a 100. évnél korábbra esne (vagyis több évet vonnánk ki, mint ami a dátumban szerepel), hiba lép fel.

Ha a szám nem Long érték, akkor kiértékelés előtt a rendszer a legközelebbi egész számra kerekíti.

Megjegyzés:   A DateAdd visszatérési értékének formátumát a Vezérlőpanel beállításai határozzák meg, és nem a dátum argumentumban átadott érték formátuma.

Megjegyzés:   A dátumban megadott dátumnak Gergely-naptár szerintinek kell lennie, ha a Calendar tulajdonság beállítása Gergely. Ha hidzsri naptárat használunk, a megadott dátumnak is hidzsri formátumúnak kell lennie. Ha a hónapot névvel adjuk meg, a névnek konzisztensnek kell lennie a Calendar tulajdonság aktuális beállításával. Ha el szeretnénk kerülni a hónapnevek és a Calendar tulajdonság aktuális beállításának ütközését, akkor a hónapokat is számokkal adjuk meg (rövid dátumformátum).

Szintaxis

DateAdd(időtartam, szám, dátum)

A DateAdd függvény szintaxisában a következő elnevezett argumentumokat különböztetjük meg:

Beállítások

Az időtartam argumentum lehetséges értékei a következők:

Következő leckéhez klikkelje!

Bezárás