Deze functie retourneert een variant (Datum).
Syntaxis
DateValue(datum)
Het argument vereiste datumis normaal gesproken een tekenreeksexpressie die een datum aangeeft van 1 januari 100 tot en met 31 december 9999. Datum kan echter elke expressie zijn die een datum, een tijd of een datum en een tijd in dat bereik kan vertegenwoordigen.
Opmerkingen
Als datum een tekenreeks is die alleen getallen bevat die door geldige datumscheidingstekens worden gescheiden, herkent DateValue de volgorde voor maand, dag en jaar op basis van 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 u het jaardeel van datum weglaat, gebruikt DateValue het huidige jaar op basis van de systeemdatum van uw computer.
Als het argument datum tijdgegevens bevat, worden deze niet geretourneerd door DateValue . Als datum echter ongeldige tijdgegevens bevat (zoals '89: 98'), treedt er een fout op.
Opmerking
Als de eigenschap Calendar voor datum is ingesteld op Gregoriaans, moet de opgegeven datum de Gregoriaanse kalender volgen. Als de kalender Hijri is, moet de opgegeven datum de notatie van de Hijri kalender volgen. Als de opgegeven datum afkomstig is uit de Hijri-kalender, dan is de datum als argument een tekenreeks die een datum aangeeft van 1/1/100 (Gregoriaans 2 aug 718) tot en met 3/4/9666 (Gregoriaans 31 december 9999).
Queryvoorbeelden
| Expression | Resultaten |
|---|---|
| SELECT DateValue([DateTime]) AS Expr1 FROM ProductSales; | Retourneert de datumwaarden van het veld 'DateTime' in de korte datumnotatie zonder de tijdinformatie. |
| 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 korte datumnotatie zonder de tijdinformatie. |
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.