Tagastab variandi (kuupäeva).
Süntaks
DateValue ( date )
argument nõutav kuupäev on tavaliselt stringavaldis, mis tähistab kuupäeva 1. jaanuarist 100 kuni 31. detsembrini 9999. Kuupäev võib aga olla ka mis tahes avaldis, mis võib tähistada selles vahemikus kuupäeva, kellaaega või nii kuupäeva kui ka kellaaega.
Kommentaarid
Kui date on string, mis sisaldab ainult kehtiva kuupäevaeraldajad eraldatud arve, tuvastab DateValue kuu, päeva ja aasta tellimuse süsteemi jaoks määratud lühikese kuupäeva vormingus. 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 argumendis date aasta osa puudub, siis kasutab DateValue teie arvutisüsteemi kuupäevas olevat praegust aastat.
Kui argument date sisaldab kellaaega, siis DateValue seda ei tagasta. Kui argument date sisaldab sobimatut kellajateavet (näiteks „89:98"), tekib tõrge.
Märkus.: Kui atribuudi Kalender sätteks on määratud Gregoriuse kalender, peab esitatud kuupäev olema Gregoriuse kalendris. 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.