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 |
|---|---|
| Vuoden | Pakollinen. Kokonaisluku. Jokin luku 100–9 999 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-argumentin 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)
Vuosi-argumentin kaksinumeroiset vuodet tulkitaan käyttäjän määrittämien koneasetusten perusteella. 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ä kaikissa muissa vuosiargumenteissa nelinumeroista vuotta (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
Jos Calendar-ominaisuuden asetus on gregoriaaninen vuoden,kuukauden ja päivän osalta, annetuksi arvoksi oletetaan gregoriaaninen. 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. Argumenttivuoden arvot 0–99 tulkitaan vuosiksi 1400–1499. Käytä kaikissa muissa vuosiarvoissa koko nelinumeroista vuotta (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.