Egy, az évet, hónapot és napot tartalmazó Variant (dátum) értéket ad eredményül.
Szintaxis
DateSerial(év; hónap; nap)
Figyelmeztetés Győződjön meg róla, hogy az argumentumok a helyes értéktartományba esnek. Az érvénytelen argumentumok helytelen eredményt adhatnak.
A DateSerial függvény argumentumai a következők:
| Argumentum | Leírás: |
|---|---|
| év | Kötelező. Egész. 100 és 9999 közötti szám vagy numerikus kifejezés. |
| hónap | Kötelező. Egész. Tetszőleges numerikus kifejezés. |
| nap | Kötelező. Egész. Tetszőleges numerikus kifejezés. |
Megjegyzések
Dátum (például 1991. december 31.) megadásához a DateSerial argumentumokhoz tartozó számtartománynak a mértékegységhez elfogadott tartományba kell esnie; Ez 1–31 napokra és 1–12 hónapokra vonatkozik. Az argumentumokhoz relatív dátumokat is megadhat azonban bármilyen numerikus kifejezés használatával, amely adott számú nappal, hónappal vagy évvel korábbi vagy későbbi dátumot jelent.
Az alábbi példában nem abszolút dátumszámok, hanem numerikus kifejezések szerepelnek. Itt a DateSerial függvény az első nap előtti napot (),1 - 1 két hónappal augusztus előtt (8 - 2), 1990 előtt 10 évvel (1990 - 10) lévő dátumot ad eredményül, azaz 1980. május 31-ét.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Az év argumentum kétjegyű értékét a rendszer a felhasználó által definiált gépbeállítások alapján értelmezi. Az alapértelmezett beállítás a következő: a 0 és 29 közötti értékeket (a két határt is beleértve) a rendszer a megfelelő 2000 és 2029 közötti évnek értelmezi. A 30 és 99 közötti értékeket a rendszer a megfelelő 1930 és 1999 közötti évnek értelmezi. Minden más évargumentumra használjon négyjegyű számot (például 1800).
A Windows 2000 előtti Windows-verziók a fent leírt alapértelmezés szerint értelmezik a kétjegyű számokkal megadott éveket. Ha biztos szeretne lenni benne, hogy a függvény a megfelelő értéket adja eredményül, négyjegyű számmal adja meg az évet.
Ha valamelyik argumentum a hozzá tartozó tartományon kívül esik, akkor a rendszer a megfelelő nagyobb egységeket használja. Ha például 35 napot ad meg, akkor a rendszer egy hónapnak és néhány napnak (hogy pontosan mennyinek, az attól függ, hogy melyik hónapról van szó) értelmezi. Ha bármelyik argumentum kisebb, mint -32 768 vagy nagyobb, mint 32 767, hiba történik. Ha a három argumentummal megadott dátum kívül esik a megengedett dátumtartományon, hiba történik.
Megjegyzés
Ha év,hónapésnap esetén a Calendar tulajdonság értéke Gergely-naptár, a megadott értéket Gergely-naptár szerint. Ha a Calendar tulajdonság iszlám naptárra van állítva, a megadott dátumnak meg kell felelnie az iszlám naptárnak.
Az eredményül visszaadott dátumrész az aktuális Visual Basic naptár időintervallum-egységeiben van megadva. Ha például az aktuális naptár az iszlám naptár, és az eredményül adott dátumrész év, akkor az év iszlám év. Az év argumentumként a 0 és 99 közötti értékeket (a két határt is beleértve) 1400 és 1499 közötti évnek értelmezi a függvény. Minden más évértékhez használjon teljes négyjegyű számot (például 1520).
Példalekérdezés
| Expression (Kifejezés) | Eredmény: |
|---|---|
| SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales; | A függvény argumentumaiban megadott év, hónap és nap "dátumát" adja eredményül, és megjeleníti a "NewDate" oszlopban. Eredmény: "13/12/2018". |
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 a Keresés elem mellett található legördülő listából a fejlesztői forrásokat választva, majd egy vagy több keresőszót megadva kaphat további tájékoztatást.
Az alábbi példában a DateSerial függvény visszaadja a megadott évnek, hónapnak, napnak megfelelő dátumot.
Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.