DateValue-Funktion

  • Artikel

Gibt einen Variant (Date) zurück.

Syntax

DateValue(date)

Das erforderliche Datumsargument ist normalerweise ein Zeichenfolgenausdruck, der ein Datum vom 1. Januar 100 bis zum 31. Dezember 9999 darstellt. date kann jedoch auch ein 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 entsprechend dem kurzen Datumsformat, das Sie für Ihr System angegeben haben. DateValue erkennt auch eindeutige Datumsangaben, die Monatsnamen, entweder in langer oder abgekürzter Form, enthalten. DateValue erkennt zum Beispiel nicht nur 30/12/1991 und 30/12/91, sondern auch 30. Dezember 1991 und 30. Dez. 1991.

Wenn das Jahr im date-Argument ausgelassen wird, verwendet das DateValue-Element das aktuelle Jahr entsprechend dem Systemdatum des Computers an.

Wenn das date-Argument eine Zeitangabe enthält, gibt DateValue diese nicht zurück. Wenn date aber eine ungültige Zeitangabe (z. B. 89:98) enthält, tritt ein Fehler auf.

Hinweis

Das für date angegebene Datum muss ein gregorianisches Datum sein, wenn die Einstellung der Calendar-Eigenschaft dem gregorianischen Kalender entspricht. Wenn es sich um einen Hijri-Kalender handelt, muss das angegebene Datum ein Hijri-Datum sein. Wenn das angegebene Datum ein Hijri-Datum ist, ist das Argument date eine Zeichenfolge, die ein Datum vom 1.1.100 (2. Aug 718 im gregorianischen Format) und 3.4.9666 (31. Dezember 9999 im gregorianischen Format) darstellt.

Beispiel

Dieses Beispiel verwendet die DateValue-Funktion, um eine Zeichenfolge in ein Datum zu konvertieren. Sie können auch Datumsliterale verwenden, um einer Variant- oder Date-Variable direkt ein Datum zuzuweisen, z. B. MyDate = #2/12/69#.

Dim MyDate
MyDate = DateValue("February 12, 1969")    ' Return a date.

Siehe auch

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.