Gibt einen Wert des Typs Variant (Date) zurück.
Syntax
DateValue ( Datum )
Das erforderliche DatumArgument ist normalerweise ein Zeichenfolgenausdruck, das ein Datum vom 1. Januar 100 bis zum 31. Dezember 9999 darstellt. Date kann jedoch auch eine beliebige Ausdruck sein, die 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 Short Date-Format, 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 von Datum weggelassen wird, verwendet DateValue das aktuelle Jahr aus dem Systemdatum des Computers.
Wenn das Datum-Argument eine Zeitangabe enthält, wird diese von DateValue nicht zurückgegeben. Enthält Datum hingegen eine ungültige Zeitangabe (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 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.