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 arról, hogy az argumentumok a megfelelő értéktartományban vannak. Az érvénytelen argumentumok helytelen eredményt eredményezhetnek.
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 megadásához (például 1991. december 31.) az egyes DateSerial argumentumok számtartományának az egység elfogadott tartományában kell lennie; azaz 1–31 nap, hónapokban 1–12. Azonban minden argumentumhoz megadhat relatív dátumokat is bármely numerikus kifejezéssel, amely egy adott dátum előtt vagy után néhány napot, hónapot vagy éveket jelöl.
Az alábbi példa numerikus kifejezéseket használ abszolút dátumszámok helyett. Itt a DateSerial függvény egy olyan dátumot ad vissza, amely az első nap előtti nap (1 - 1), két hónappal augusztus előtt (8 - 2), 10 évvel 1990 előtt (1990 - 10); más szóval 1980. május 31.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Az év argumentum kétjegyű évszámát a felhasználó által megadott gépbeállítások alapján értelmezi a rendszer. 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 év argumentumhoz használjon négyjegyű évet (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
Év,hónap és nap esetén, ha a Calendar tulajdonság értéke Gergely-naptár, a megadott érték Gergely-naptár szerinti értéknek számít. 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 argumentumban a 0 és 99 közötti értékeket a rendszer az 1400–1499 közötti évekként értelmezi. Minden más évértékhez használja a teljes négyjegyű évet (például 1520).
Példa lekérdezésre
| Kifejezés | Eredmény: |
|---|---|
| SELECT Dateserial(2018.12.13) AS NewDate FROM ProductSales; | A függvény argumentumaiban megadott adott év, hónap és nap "dátumát" adja vissza, és az "ÚjDátum" oszlopban jelenik meg. 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.