Gibt einen Wert des Typs Variant (Date) zurück.
Syntax
DateValue(date)
Das erforderliche Datumsargumentist normalerweise ein Zeichenfolgenausdruck, der ein Datum vom 1. Januar 100 bis zum 31. Dezember 9999 darstellt. Date kann jedoch auch ein beliebiger Ausdruck sein, der ein Datum, eine Uhrzeit oder ein Datum und eine Uhrzeit in diesem Bereich darstellen kann.
Hinweise
Wenn date 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 format short date, das Sie für Ihr System angegeben haben. DateValue erkennt auch eindeutige Datumsangaben, die Monatsnamen in langer oder abgekürzter Form enthalten. Beispielsweise erkennt DateValue zusätzlich zum 30.12.1991 und 30.12.91 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 date Zeitinformationen enthält, gibt DateValue diese nicht zurück. Wenn datum jedoch ungültige Zeitinformationen enthält (z. B. "89:98"), tritt ein Fehler auf.
Hinweis
Wenn die Calendar-Eigenschaftseinstellung 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 Argumentdatum eine Zeichenfolge , die ein Datum vom 1.1.100 (Gregorian Aug 2, 718) bis 4/3/9666 (Gregorian Dec 31, 9999) darstellt.
Abfragebeispiele
| Ausdruck | Ergebnisse |
|---|---|
| SELECT DateValue([DateTime]) AS Expr1 FROM ProductSales; | Gibt die Datumswerte des Felds "DateTime" im Short-Datumsformat ohne die Zeitinformationen 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 Short-Datumsformat ohne die Zeitinformationen 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.