Datumwaarde, functie
Van toepassing op
Deze functie retourneert een variant (Datum).
Syntaxis
DateValue(date)
Het vereiste datumargumentis normaal gesproken een tekenreeksexpressie die een datum vertegenwoordigt van 1 januari 100 tot en met 31 december 9999. Datum kan echter ook elke expressie zijn die een datum, een tijd of zowel een datum als een tijd in dat bereik kan vertegenwoordigen.
Opmerkingen
Als datum een tekenreeks is die alleen getallen bevat, gescheiden door geldige datumscheidingstekens, herkent DateValue de volgorde voor maand, dag en jaar volgens de korte datumnotatie die u voor uw systeem hebt opgegeven. DateValue herkent ook eenduidige datums die maandnamen bevatten, hetzij in lange of verkorte vorm. Dit betekent dat DateValue niet alleen 30-12-1991 en 30-12-91 herkent maar ook 30 december 1991 en 30 dec 1991.
Als het jaargedeelte van de datum wordt weggelaten, gebruikt DateValue het huidige jaar van de systeemdatum van uw computer.
Als het datumargument tijdgegevens bevat, retourneert DateValue deze niet. Als datum echter ongeldige tijdgegevens bevat (zoals '89:98'), treedt er een fout op.
Opmerking
Als deeigenschapsinstelling Calendar Gregoriaans is, moet de opgegeven datum gregoriaans zijn. Als de kalender Hijri is, moet de opgegeven datum de notatie van de Hijri kalender volgen. Als de opgegeven datum Hijri is, is de argumentdatum een tekenreeks die een datum aangeeft van 1-1-100 (Gregoriaans 2 augustus 718) tot en met 3-4-9666 (Gregoriaans 31 december 9999).
Queryvoorbeelden
| Expression | Resultaten |
|---|---|
| SELECT DateValue([DateTime]) AS Expr1 FROM ProductVerkoop; | Retourneert de datumwaarden van het veld 'DateTime' in de datumnotatie Short zonder de tijdgegevens. |
| SELECT DateValue([DateTime]) AS NewDate, Count(ProductSales.DateTime) AS CountOfDateTime FROM ProductSales GROUP BY DateValue([DateTime]); | Retourneert de datumwaarden van het veld 'DateTime' in de datumnotatie Short zonder de tijdgegevens. |
VBA-voorbeeld
Opmerking
In de volgende voorbeelden wordt het gebruik van deze functie in een VBA-module (Visual Basic for Applications) toegelicht. Meer informatie over het werken met VBA vindt u door in de vervolgkeuzelijst naast Zoeken de optie Referentie voor ontwikkelaars te selecteren en een of meer termen in het zoekvenster te typen.
In dit voorbeeld wordt de functie DateValue gebruikt om een tekenreeks te converteren naar een datum. U kunt ook letterlijke datums gebruiken om een datum rechtstreeks toe te wijzen aan een variabele van het type Variant of Datum, bijvoorbeeld MijnDatum = #2/12/69 #.
Dim MyDate
MyDate = DateValue("February 12, 1969") ' Return a date.