Palauttaa variantin (päivämäärä).
Syntaksi
Päiväysarvo ( päivämäärä )
Pakollinen 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ää, kellonaikaa tai molempia kyseisellä alueella.
Huomautuksia
Jos päivämäärä on merkkijono, joka sisältää vain kelvollisen päivämääräerottimet erotetut luvut, DateValue tunnistaa kuukauden, päivän ja vuoden tilauksen järjestelmällesi määrittämäsi Lyhyen päivämäärän muotoilun mukaisesti. DateValue tunnistaa myös yksiselitteiset päivämäärät, jotka sisältävät kuukausien nimet joko pitkässä tai lyhennetyssä muodossa. Esimerkiksi 30.12.1991 ja 30.12.1991 tunnistamisen lisäksi DateValue tunnistaa myös 30.12.1991 ja 30.12.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än argumentti sisältää aikatiedot, 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 kalenteriominaisuusasetus on gregoriaaninen, päivämäärän on oltava gregoriaaninen. Islamilaista kalenteria käytettäessä päivämäärä täytyy antaa islamilaisen kalenterin mukaisena. Jos annettu päivämäärä on Hijri, argumentin päivämäärä on merkkijono , joka vastaa päivämäärää 1.1.2000 (gregoriaaninen 2. elokuuta 718) – 3.4.9666 (gregoriaaninen 31.12.9999).
Esimerkkejä kyselystä
|
Lauseke |
Tulokset |
|
SELECT DateValue([DateTime]) AS Expr1 FROM ProductSales; |
Palauttaa päivämääräarvot kentästä "DateTime" 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äarvot kentästä "DateTime" 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.
