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–9 999 tai numeerinen lauseke. |
| kuukausi | Pakollinen. Kokonaisluku. Mikä tahansa numeerinen lauseke. |
| päivä | Pakollinen. Kokonaisluku. Mikä tahansa numeerinen lauseke. |
Huomautuksia
Jos haluat määrittää päivämäärän, kuten 31.12.1991, kunkin DateSerial-argumentin numeroalueen on oltava yksikön hyväksytyllä alueella. Päivien osalta 1–31 ja kuukausien osalta 1–12. Voit kuitenkin määrittää suhteelliset päivämäärät kullekin argumentille käyttämällä mitä tahansa numeerista lauseketta, joka vastaa jotakin päivää, kuukausia tai vuotta ennen tiettyä päivämäärää tai sen jälkeen.
Seuraavassa esimerkissä käytetään absoluuttisten päivämäärälukujen asemesta numeerisia lausekkeita.
DateSerial-funktio palauttaa esimerkissä päivämäärän, joka on ensimmäistä päivää edeltävä päivä (1 - 1), kaksi kuukautta ennen elokuuta (8 - 2), 10 vuotta ennen vuotta 1990 (1990 - 10); toisin sanoen päivämäärän 31. toukokuuta 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Vuosi-argumentin kaksinumeroiset vuosiluvut tulkitaan käyttäjän määrittämien tietokoneen asetusten 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 vuosilukua (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 vuoden,kuukaudenjapäivän Calendar-ominaisuusasetus on gregoriaaninen, annetun arvon oletetaan olevan 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. Argumentissa vuosi arvot 0–99 (ääriarvot mukaan lukien) tulkitaan vuosiksi 1400–1499. Käytä kaikkiin muihin vuosiarvoihin täydellistä nelinumeroista vuosilukua (esimerkiksi 1520).
Kyselyesimerkki
| Lauseke | Tulokset |
|---|---|
| SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales; | Palauttaa funktion argumentteihin määritetyn vuoden, kuukauden ja päivän "päivämäärän", joka näkyy sarakkeessa "UusiPäivämäärä". Tulos: "13/12/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.