DateSerial-Funktion

  • Artikel

Gibt einen Variant-Wert (Date) für ein bestimmtes Jahr, einen bestimmten Monat und einen bestimmten Tag zurück.

Syntax

DateSerial(year, month, day)

Die Syntax der DateSerial-Funktion enthält die folgenden benannten Argumente:

Bestandteil Beschreibung
year Erforderlich; Ganze Zahl. Zahl zwischen 100 und 9999 (einschließlich) oder einen numerischen Ausdruck.
Monat Erforderlich; Ganze Zahl. Beliebiger numerischer Ausdruck.
day Erforderlich; Ganze Zahl. Jeder numerischer Ausdruck.

HinwBemerkungeneise

Um ein Datum wie den 31. Dezember 1991 anzugeben, sollte der Zahlenbereich für jedes DateSerial-Argument im zulässigen Bereich für die Einheit liegen. d. h. 1–31 für Tage und 1–12 für Monate. Sie können jedoch auch relative Datumswerte für jedes Argument angeben, indem Sie einen beliebigen numerischen Ausdruck verwenden, der eine Anzahl von Tagen, Monaten oder Jahren vor oder nach einem bestimmten Datum angibt.

Im folgende Beispiel werden numerische Ausdrücke anstelle von absoluten Datumswerten verwendet. Hierbei gibt die DateSerial-Funktion ein Datum zurück, bei dem es sich um den Tag vor dem ersten Tag (1 - 1) handelt, zwei Monate vor August (8 - 2), 10 Jahre vor 1990 (1990 - 10), das heißt, 31. Mai 1980.

Unter Windows 98 oder Windows 2000 werden zweistellige Jahreswerte für das Jahr-Argument auf Grundlage der benutzerdefinierten Computereinstellungen interpretiert. Standardmäßig werden Werte zwischen 0 und 29 (einschließlich) als die Jahre 2000–2029 interpretiert werden. Die Standardwerte zwischen 30 und 99 werden als die Jahre von 1930 bis 1999 interpretiert. Verwenden Sie für alle anderen Jahr-Argumente eine vierstellige Jahresangabe (z. B. 1800).

Frühere Versionen von Windows interpretieren zweistellige Jahresangaben entsprechend den oben beschriebenen Standardeinstellungen. Um sicherzustellen, dass die Funktion den korrekten Wert zurückgibt, verwenden Sie eine vierstellige Jahresangabe.

Wenn ein Argument den zulässigen Bereich für das Argument überschreitet, wird es ggf. auf die nächstgrößere Einheit geändert. Wenn Sie beispielsweise 35 Tage angeben, wird es als ein Monat und einige Tage gewertet, je nachdem, zu welchem Zeitpunkt im Jahr es angewendet wird. Wenn ein Argument außerhalb des zulässigen Bereichs von -32.768 bis 32.767 liegt, tritt ein Fehler auf. Wenn das durch die drei Argumente angegebene Datum außerhalb des zulässigen Datumsbereichs liegt, tritt ein Fehler auf.

Hinweis

Für Jahr, Monat, und Tag, wird bei dem angegegebenen Wert davon ausgegangen, er wäre gregorianisch, wenn die Calender-Eigenschaft Gregorianisch lautet. Wenn die Calender-Eigenschaftseinstellung Hijri lautet, wird bei dem angegegebenen Wert davon ausgegangen, dass es Hijri ist.

Der zurückgegebene Datumsbestandteil wird in Zeitraumeinheiten des aktuellen arabischen Kalenders angegeben. Wenn der aktuelle Kalender ein Hijri-Kalender ist und der zurückzugebenden Datumsbestandteil das Jahr ist, so ist der Jahreswert ein Hijri-Jahr. Für das Argument Year werden Werte zwischen 0 und 99 (einschließlich) als die Jahre 1400–1499 interpretiert. Verwenden Sie für alle anderen Jahr-Werte die vollständige vierstellige Jahresangabe (z. B. 1520).

Beispiel

In diesem Beispiel wird mit der DateSerial-Funktion das Datum für das angegebene Jahr, den Monat und den Tag zurückgegeben.

Dim MyDate
' MyDate contains the date for February 12, 1969.
MyDate = DateSerial(1969, 2, 12)    ' 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.