Access függvényei
DateSerial függvény

DateSerial függvény

Egy Variant (Date) típussal tér vissza, amelynek tartalma a megadott év, hónap és nap.

Ha dátumot akarunk megadni – mint például 1991. december 31. –, akkor a DateSerial argumentumaiként átadott számoknak rendre a megfelelő tartományba kell esniük; a napok esetében ez az 1-31, a hónapok esetében pedig az 1-12 tartomány. Az argumentumoknak adott dátumhoz képest valahány nappal, hónappal vagy évvel későbbi vagy korábbi dátumot meghatározó numerikus kifejezéseket adva értékül relatív dátumokat is megadhatunk.

Az alábbi példában abszolút dátumok helyett numerikus kifejezéseket használunk. Ebben az esetben a DateSerial függvény azt a dátumot adja vissza, amely az első előtti napra (1 - 1), augusztushoz képest két hónappal korábbra (8 - 2), 1990-hez képest pedig 10 évvel korábbra (1990 - 10) esik; ez pontosan 1980. május 31. lesz.

DateSerial(1990 - 10, 8 - 2, 1 - 1)

Ha Windows 2000 operációs rendszerben az év argumentumnak csak két számjegyet adunk meg, akkor ezek értelmezése a számítógép felhasználó által megadott beállításainak alapján történik. Alapértelmezés szerint a 0 és 29 közötti, illetve ezekkel egyenlő értékeket 2000–2029 közötti évekként, míg a 30 és 99 közötti értékeket 1930–1999 közötti évekként értelmezi a rendszer. Az egyéb évszámok esetében az év argumentumnak négy számjegyet kell tartalmaznia (például: 1800).

A Windows korábbi változatai a fenti alapértelmezések szerint kezelik a kétszámjegyű évszámokat. Ha biztosak akarunk lenni abban, hogy a függvény pontos értéket ad vissza, használjunk négyjegyű évszámokat.

Ha bármelyik argumentum a számára elfogadható tartományon kívülre esik, akkor a következő, nagyobb egységet növeli meg. Ha például 35 napot adunk meg, az egy hónapot és – attól függően, hogy az év mely hónapjáról van szó – néhány napot jelent. Ha bármelyik argumentum kívül esik a -32768 - 32767 tartományon, hiba lép fel. Ha a három argumentum által meghatározott dátum az elfogadható dátumtartományon kívülre esik, ugyancsak hiba történik.

Megjegyzés:  Az év, a hónap és a nap értékét a rendszer Gergely-naptár szerint kezeli, ha a Calendar tulajdonság beállítása Gergely. Ha a Calendar tulajdonság beállítása hidzsri, a rendszer a megadott értékeket is ekként értelmezi.

A kapott dátumrész az aktuális Visual Basic naptár időmérő egységében szerepel. Ha például az aktuális naptár a hidzsri, és a kért dátumrész az év, akkor a megadott érték hidzsri években értendő. Az év argumentum esetében a 0 és 99 közötti értékeket a rendszer az 1400-1499 közötti tartományként értelmezi. Ha más évszámot szeretnénk megjelölni, akkor az év argumentumnak négyszámjegyű értéket kell adnunk (például: 1520).

 

Szintaxis

DateSerial(év, hónap, nap)

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

Rész

Leírás

év

Kötelező, Integer. Egy 100 és 9999 közötti szám (lehet 100 és 9999 is) vagy egy numerikus kifejezés.

hónap

Kötelező, Integer. Tetszőleges numerikus kifejezés.

nap

Kötelező, Integer. Tetszőleges numerikus kifejezés.

Következő leckéhez klikkelje!

Bezárás