Gibt einen Wert des Typs Variant (Date) zurück.
Syntax
DateValue(date)
Das erforderliche date-Argumentist normalerweise ein Zeichenfolgenausdruck, der ein Datum vom 1. Januar 100 bis zum 31. Dezember 9999 darstellt. "Datum" kann jedoch auch ein beliebiger Ausdruck sein, der ein Datum, eine Uhrzeit oder sowohl ein Datum als auch eine Uhrzeit in diesem Bereich darstellen kann.
Hinweise
Wenn "Datum " eine Zeichenfolge ist, die nur Zahlen enthält, die durch gültige Datumstrennzeichen getrennt sind, erkennt DateValue die Reihenfolge für Monat, Tag und Jahr gemäß dem kurzen Datumsformat, das Sie für Ihr System festgelegt haben. DateValue erkennt auch eindeutige Datumsangaben mit Monatsnamen in langer oder abgekürzter Form. So erkennt DateValue z. B. nicht nur den 30.12.1991 und den 30.12.91, sondern auch den 30. Dezember 1991 und den 30. Dezember 1991.
Wenn der Jahresteil des Datums weggelassen wird, verwendet DateValue das aktuelle Jahr aus dem Systemdatum Ihres Computers.
Wenn das Argument "Datum " Zeitinformationen enthält, wird diese von "DateValue" nicht zurückgegeben. Wenn das Datum jedoch ungültige Zeitinformationen enthält (z. B. "89:98"), tritt ein Fehler auf.
Hinweis
Wenn die Einstellung der Calendar-Eigenschaft für "Date" gregorianisch ist, muss das angegebene Datum gregorianisch sein. Wenn es sich um einen Hijri-Kalender handelt, muss das angegebene Datum ein Hijri-Datum sein. Wenn das angegebene Datum Hijri ist, ist das Argument Datum eine Zeichenfolge , die ein Datum zwischen 01.01.100 (Gregorianisch 2. August 718) bis 03.04.9666 (Gregorianisch 31. Dezember 9999) darstellt.
Abfragebeispiele
| Ausdruck | Ergebnisse |
|---|---|
| SELECT DateValue([DateTime]) AS Expr1 FROM ProductSales; | Gibt die Datumswerte des Felds "DateTime" im kurzen Datumsformat ohne die Zeitangabe zurück. |
| SELECT DateValue([DateTime]) AS NewDate, Count(ProductSales.DateTime) AS CountOfDateTime FROM ProductSales GROUP BY DateValue([DateTime]); | Gibt die Datumswerte des Felds "DateTime" im kurzen Datumsformat ohne die Zeitangabe zurück. |
VBA-Beispiel
Hinweis
Die folgenden Beispiele zeigen die Verwendung dieser Funktion in einem VBA-Modul (Visual Basic for Applications). Wenn Sie weitere Informationen zum Arbeiten mit VBA wünschen, wählen Sie Entwicklerreferenz in der Dropdownliste neben Suchen aus, und geben Sie einen oder mehrere Begriffe in das Suchfeld ein.
In diesem Beispiel wird die DateValue-Funktion verwendet, um eine Zeichenfolge in ein Datum umzuwandeln. Sie können auch Datumsliterale verwenden, um direkt ein Datum zu einer Variant- oder Date-Variablen zuzuweisen, z. B. MyDate = #2/12/69#.
Dim MyDate
MyDate = DateValue("February 12, 1969") ' Return a date.