Palauttaa määritetyn vuoden, kuukauden ja päivän variantin (päivämäärän).
Syntaksi
DateSerial ( vuosi, kuukausi, päivä )
Varoitus Varmista, että argumentit ovat oikealla arvoalueella. Virheellinen argumentti voi johtaa virheelliseen tulokseen.
TimeSerial-funktion syntaksilla on seuraavat argumentit:
|
Argumentti |
Kuvaus |
|
vuosi |
Pakollinen. Kokonaisluku. Jokin luku 100–9999 (raja-arvot sisältyvät alueeseen) tai numeerinen lauseke. |
|
kuukausi |
Pakollinen. Kokonaisluku. Mikä tahansa numeerinen lauseke. |
|
päivä |
Pakollinen. Kokonaisluku. Mikä tahansa numeerinen lauseke. |
Huomautuksia
Päivämäärän, kuten 31.12.1991, määrittämiseksi kunkin DateSerial -argumentti numeroalueen pitäisi olla yksikön hyväksytyllä alueella. eli 1–31 päivälle ja 1–12 kuukausille. Voit kuitenkin myös määrittää kullekin argumentille suhteelliset päivämäärät käyttämällä mitä tahansa numeerista lauseketta, joka edustaa tiettyä päivämäärää edeltäviä tai sitä seuraavia päiviä, kuukausia tai vuosia.
Seuraavassa esimerkissä käytetään numeerisia lausekkeita suorien päivämäärälukujen sijaan. Tässä DateSerial-funktio palauttaa päivämäärän, joka on päivää ennen ensimmäistä päivää (1 - 1), kaksi kuukautta ennen elokuuta (8 - 2), 10 vuotta ennen vuotta 1990 (1990 - 10); toisin sanoen 31. toukokuuta 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Kaksinumeroiset vuosiluvut vuosi-argumentille tulkitaan käyttäjän määrittämien koneen asetusten mukaan. Oletusarvoisesti arvot 0–29 (raja-arvot sisältyvät alueeseen) tulkitaan vuosiksi 2000–2029. Oletusarvot välillä 30–99 tulkitaan vuosiksi 1930–1999. Käytä muita vuosi-argumentteja varten nelinumeroisia vuosilukuja (esimerkiksi 1800).
Windows 2000 -versiota vanhemmat Windows-versiot tulkitsevat kaksinumeroiset vuosiluvut edellä kuvattujen oletusarvojen mukaisesti. Käyttämällä nelinumeroista vuosilukua voit varmistaa, että funktio palauttaa oikean arvon.
Jos jokin argumenteista ylittää kyseisen argumentin normaalin alueen, se muutetaan seuraavaan suurempaan yksikköön tarpeen mukaan. Jos määrität esimerkiksi 35 päivää, se arvioidaan yhdeksi kuukaudeksi ja joiksikin päiviksi riippuen siitä, missä kohtaa vuotta sitä käytetään. Jos jokin yksittäinen argumentti on alueen -32 768–32 767 ulkopuolella, virhe ilmenee. Jos kolmen argumentin määrittämä päivämäärä aiheuttaa sen, että päivämäärä on hyväksyttävän päivämääräalueen ulkopuolella, virhe ilmenee.
Huomautus: Kun määrität vuoden, kuukauden ja päivän ja kalenterin ominaisuusasetus on Gregoriaaninen, annettujen arvojen oletetaan olevan gregoriaanisia. Jos kalenterin ominaisuusasetus on Islamilainen, annettujen arvojen oletetaan olevan islamilaisia.
Palautettu päivämääräosa noudattaa nykyisen Visual Basic -kalenterin aikajaksoyksiköitä. Jos käytössä on esimerkiksi islamilainen kalenteri ja palautettava päivämääräosa on vuosi, vuosiarvo ilmoitetaan islamilaisen kalenterin vuotena. Vuosi-argumentille arvot 0–99 (raja-arvot sisältyvät alueeseen) tulkitaan vuosiksi 1400–1499. Käytä muita vuosi-argumentteja varten täydellisiä nelinumeroisia vuosilukuja (esimerkiksi 1520).
Esimerkki kyselystä
|
Lauseke |
Tulokset |
|
SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales; |
Palauttaa määritetyn vuoden, kuukauden ja päivän päivämäärän, joka on kirjoitettu funktion argumentteihin ja joka näkyy Sarakkeessa "UusiPäivämäärä". Tulos: "12.13.2018". |
VBA-esimerkki
Huomautus: Seuraavissa esimerkeissä kerrotaan, kuinka tätä funktiota käytetään Visual Basic for Applications (VBA) -moduulissa. Jos haluat lisätietoja VBA:n käytöstä, valitse Sovelluskehittäjän opasHaku-kentän viereisestä luettelosta ja anna yksi tai useampi hakuehto hakukenttään.
Tässä esimerkissä DateSerial-funktio palauttaa määritetyn vuoden, kuukauden ja päivän päivämäärän.
Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.
