Tagastab variandi (kuupäeva).
Süntaks
DateValue(date)
Nõutav kuupäevaargumenton tavaliselt stringiavaldis, mis tähistab kuupäeva 1. jaanuarist 100 kuni 31. detsembrini 9999. Kuupäev võib aga olla ka mis tahes avaldis, mis tähistab selles vahemikus kuupäeva, kellaaega või nii kuupäeva kui ka kellaaega.
Kommentaarid
Kui date on string, mis sisaldab ainult kehtiva kuupäevaeraldajatega eraldatud arve, tuvastab DateValue teie süsteemi jaoks määratud lühikese kuupäeva vormingus kuu, päeva ja aasta tellimuse. DateValue tuvastab ka üheselt mõistetavad kuupäevad, mis sisaldavad kuunimesid (pikal või lühendatud kujul). Näiteks 30.12.1991 ja 30.12.91 tunnistab DateValue lisaks 30. detsembrile 1991 ja 30. detsembrile 1991.
Kui kuupäeva aastaosa puudub, kasutab funktsioon DateValue arvuti süsteemikuupäevast pärinevat jooksvat aastat.
Kui argument date sisaldab kellaajateavet, ei tagasta funktsioon DateValue seda. Kui aga kuupäev sisaldab sobimatut kellaajateavet (nt "89:98"), ilmneb tõrge.
Märkus.
Kui argumendi dateatribuudi Calendar säte on Gregoriuse, peab esitatud kuupäev olema Gregoriuse täht. Islami kalendri korral tuleb kasutada islami ajaarvestusele vastavat kuupäeva. Kui esitatud kuupäev on Hijri, on argumendi kuupäevString , mis tähistab kuupäeva 1.01.100 (Gregoriuse 2. aug 718) kuni 03.04.9666 (Gregoriuse dets 31, 9999).
Päringu näited
| Avaldis | Tulemid |
|---|---|
| SELECT DateValue([DateTime]) AS Avaldis1 FROM Tootemüük; | Tagastab välja "KuupäevKellaaeg" kuupäevaväärtused lühikeses kuupäevavormingus ilma kellaajateabeta. |
| SELECT DateValue([DateTime]) AS NewDate, Count(ProductSales.DateTime) AS CountOfDateTime FROM ProductSales GROUP BY DateValue([DateTime]); | Tagastab välja "KuupäevKellaaeg" kuupäevaväärtused lühikeses kuupäevavormingus ilma kellaajateabeta. |
VBA näide
Märkus.
Järgmised näited kujutavad selle funktsiooni kasutamist rakenduse Visual Basic for Applications (VBA) moodulis. Lisateabe saamiseks VBA-ga töötamise kohta valige välja Otsing kõrval kuvatavast ripploendist väärtus Tootearendusmaterjal ja sisestage otsinguväljale üks või mitu sõna.
Järgmises näites teisendatakse string funktsiooni DateValue abil kuupäevaks. Muutujale Variant või Kuupäev saate kuupäeva määrata ka kuupäevaliteraale kasutades (näide: MyDate = #2/12/69#).
Dim MyDate
MyDate = DateValue("February 12, 1969") ' Return a date.