Palauttaa variantin (päivämäärä).
Syntaksi
DateValue(date)
Vaadittu päivämäärä-argumentti on yleensä merkkijonolauseke, joka vastaa jotakin päivämäärää 1.1.100–31.12.9999. Päivämäärä voi kuitenkin olla myös mikä tahansa lauseke, joka vastaa päivämäärää, ajankohtaa tai molempia kyseisellä alueella.
Huomautuksia
Jos päivämäärä on merkkijono, joka sisältää vain kelvollisilla päivämääräerottimilla erotettuja lukuja, Päiväysarvo tunnistaa kuukauden, päivän ja vuoden järjestyksen järjestelmään määritetyn lyhyen päivämäärämuodon mukaisesti. Päiväysarvo tunnistaa myös yksiselitteiset päivämäärät, jotka sisältävät kuukausien nimet joko pitkässä tai lyhennetyssä muodossa. Esimerkiksi sen lisäksi, että DateValue tunnistaa muodot 30.12.1991 ja 30.12.91, se tunnistaa myös muodot 30. joulukuuta 1991 ja 30. joulukuuta 1991.
Jos päivämäärän vuosiosa jätetään pois, Päiväysarvo käyttää tietokoneen järjestelmäpäivämäärän nykyistä vuotta.
Jos päivämääräargumentti sisältää aikatietoja, Päiväysarvo ei palauta niitä. Jos päivämäärä kuitenkin sisältää virheellisiä päivämäärätietoja (kuten "89:98"), tapahtuu virhe.
Huomautus
Jos Calendar-ominaisuusasetus on gregoriaaninen, päivämäärän täytyy antaa gregoriaaninen. Islamilaista kalenteria käytettäessä päivämäärä täytyy antaa islamilaisen kalenterin mukaisena. Jos annettu päivämäärä on islamilainen, argumentti päivämäärä on merkkijono, joka vastaa päivämäärää 1.1.2010 (gregoriaaninen 2. elokuuta 718) – 3.4.9666 (gregoriaaninen 31. joulukuuta 9999).
Esimerkkejä kyselyistä
| Lauseke | Tulokset |
|---|---|
| SELECT DateValue([DateTime]) AS Expr1 FROM ProductSales; | Palauttaa päivämäärä- ja aikakentän päivämääräarvot lyhyessä päivämäärämuodossa ilman aikatietoja. |
| SELECT DateValue([DateTime]) AS NewDate, Count(ProductSales.DateTime) AS CountOfDateTime FROM ProductSales GROUP BY DateValue([DateTime]); | Palauttaa päivämäärä- ja aikakentän päivämääräarvot lyhyessä päivämäärämuodossa ilman aikatietoja. |
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ä Päiväysarvo-funktiolla merkkijono muunnetaan päivämääräksi. Voit myös käyttää päivämääräliteraaleja päivämäärän määrittämiseen suoraan varianttiin tai Päivämäärä-muuttujaan, esimerkiksi MyDate = #12.2.69#.
Dim MyDate
MyDate = DateValue("February 12, 1969") ' Return a date.