Tagastab määratud aastat, kuud ja päeva tähistava väärtuse andmetüübiga variant (Date).
Süntaks
DateSerial ( aasta, kuu, päev )
Hoiatus! Veenduge, et argumendid oleksid õiges väärtustevahemikus. Sobimatu argument võib põhjustada vale tulemi.
Funktsioonil DateSerial on järgmised argumendid.
|
Argument |
Kirjeldus |
|
aasta |
Nõutav. Täisarv. Täisarv vahemikus 100–9999 (k.a) või arvuline avaldis. |
|
kuu |
Nõutav. Täisarv. Mis tahes arvavaldis. |
|
päev |
Nõutav. Täisarv. Mis tahes arvavaldis. |
Kommentaarid
Kuupäeva (nt 31. detsember 1991) määramiseks peaks iga kuupäeva kuupäevavahemikuargument arvuvahemik olema ühiku jaoks lubatud vahemikus; st 1–31 päeva ja 1–12 kuud. Siiski saate iga argumendi jaoks määrata suhtelised kuupäevad mis tahes arvulise avaldise abil, mis tähistab teatud arvu päevi, kuid või aastaid enne või pärast teatud kuupäeva.
Järgmises näites kasutatakse absoluutse kuupäevanumbri asemel arvulisi avaldisi. Siin tagastab funktsioon DateSerial kuupäeva, mis on päev enne esimest päeva (1 - 1), kaks kuud enne augustit (8 - 2), 10 aastat enne 1990. aastat (1990 - 10); 31. mai 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Aastat tähistava argumendi kahekohalisi väärtusi tõlgendatakse vastavalt kasutaja määratud seadmesätetele. Väärtusi vahemikus 0–29 (k.a) tõlgendatakse vaikimisi aastatena 2000–2029. Väärtusi vahemikus 30–99 tõlgendatakse vaikimisi aastatena 1930–1999. Kõigi muude aasta argumentidena kasutage neljakohalist arvu (nt 1800).
Windows 2000-st varasemad versioonid tõlgendavad kahekohalisi aastaväärtusi ülaltoodud vaikesätete põhjal. Kui soovite olla kindel, et funktsioon tagastab õige väärtuse, kasutage neljakohalist aastaväärtust.
Kui mõne argumendi väärtus on suurem vastava argumendi sobivate väärtuste vahemikust, suurendatakse seda vastavalt järgmise ühikuni. Näiteks kui määrate päevaväärtuseks 35, arvestatakse seda ühe kuu ja mõne lisapäevana olenevalt sellest, millise kuu jaoks seda kasutatakse. Kui argument on väljaspool vahemikku -32 768–32 767, ilmneb tõrge. Tõrge ilmneb ka siis, kui kolme argumendiga määratletud kuupäev jääb väljapoole sobivat kuupäevavahemikku.
Märkus.: Kui atribuudi Kalender sätteks on määratud „Gregoriuse“, peab argumentide aasta, kuu ja päev määrama samuti Gregoriuse kalendri järgi. Kui atribuudi Kalender väärtuseks on „Hidžra“, peavad ka kõik väärtused olema hidžra kalendrile vastavad.
Kuupäevaosa tagastatakse praeguse Visual Basicu kalendri ajaperioodi ühikutes. Näiteks kui kasutusel on hidžra kalender ja kuupäevaosana tagastatakse aasta, vastab selle aasta väärtus hidžra kalendrile. Argumendi aasta väärtusi vahemikus 0–99 (k.a) tõlgendatakse aastatena 1400–1499. Kõigi muude argumendi aasta väärtuste tagastamiseks kasutage neljakohalist arvu (nt 1520).
Päringu näide
|
Avaldis |
Tulemid |
|
SELECT Dateserial(2018;12;13) AS NewDate FROM ProductSales; |
Tagastab funktsiooni argumentidesse sisestatud määratud aasta, kuu ja päeva "kuupäeva", mis kuvatakse veerus "UusKuupäev". Tulem: "12.13.2018". |
VBA näide
Märkus.: Järgmised näited kujutavad selle funktsiooni kasutamist rakenduse Visual Basic for Applications (VBA) moodulis. Lisateabe saamiseks VBA-ga töötamise kohta valige välja Otsing kõrval kuvatavast ripploendist väärtus Tootearendusmaterjal ja sisestage otsinguväljale üks või mitu sõna.
Järgmises näites kasutatakse funktsiooni DateSerial määratud aasta, kuu ja päeva kuupäevaväärtuse tagastamiseks.
Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.
