DateSerial (Funktion)

Gibt einen Wert des Typs Variant (Date) für ein angegebenes Jahr, einen Monat und einen Tag zurück.

Syntax

DateSerial(year, month, day)

Warnung Stellen Sie sicher, dass sich die Argumente im richtigen Wertebereich befinden. Ein ungültiges Argument kann zu einem falschen Ergebnis führen.

Die Syntax der Funktion DateSerial weist die folgenden Argumente auf:

Argument	Beschreibung
Jahr	Erforderlich. Ganze Zahl. Zahl zwischen 100 und 9999 oder ein numerischer Ausdruck.
Monat	Erforderlich. Integer. Beliebiger numerischer Ausdruck.
Tag	Erforderlich. Integer. Beliebiger numerischer Ausdruck.

Hinweise

Zum Angeben eines Datums, z. B. 31. Dezember 1991, sollte der Zahlenbereich für jedes Argument "DateSerial" 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 Datumsangaben 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 darstellt.

Im folgenden Beispiel werden numerische Ausdrücke anstelle von absoluten Datumsangaben verwendet. Hier gibt die DatSeriell-Funktion ein Datum zurück, das der Tag vor dem ersten Tag (1 - 1), zwei Monate vor August (8 - 2), 10 Jahre vor 1990 (1990 - 10) ist, also der 31. Mai 1980.

DateSerial(1990 - 10, 8 - 2, 1 - 1)

Zweistellige Jahresangaben für das Argument "Jahr " werden basierend auf benutzerdefinierten Computereinstellungen interpretiert. Die Standardeinstellung gibt vor, dass Werte zwischen 0 und 29 (einschließlich) als die Jahre 2000 bis 2029 interpretiert werden. Die Standardwerte zwischen 30 und 99 werden als die Jahre 1930 bis 1999 interpretiert. Verwenden Sie für alle anderen Jahresargumente eine vierstellige Jahresangabe (z. B. 1800).

In Windows-Versionen vor Windows 2000 werden zweistellige Jahresangaben entsprechend den oben beschriebenen Standardeinstellungen interpretiert. Um sicherzustellen, dass die Funktion jeweils den korrekten Wert zurückgibt, sollten Sie eine vierstelligen Jahresangabe verwenden.

Wenn ein Argument den für es gültigen Bereich überschreitet, wird es auf die entsprechende nächstgrößere Einheit erhöht. Wenn Sie beispielsweise 35 Tage angeben, wird dies als ein Monat und einige Tage ausgewertet, je nachdem, auf welchen Bereich des Jahres die Angabe angewendet wird. Liegt irgendein Argument außerhalb des Bereichs von -32.768 bis 32.767 ist, tritt ein Fehler auf. Wenn das durch die drei Argumente angegebene Datum außerhalb des zulässigen Datumsbereichs liegt, tritt ein Fehler auf.

Der zurückgegebene Datumsbestandteil liegt in Zeitraumeinheiten des aktuellen Visual Basic-Kalenders vor. Wenn beispielsweise der aktuelle Kalender ein Hijri-Kalender ist und der zurückzugebende Datumsbestandteil das Jahr ist, ist der Jahreswert ein Hijri-Jahr. Für das Argument Jahr werden Werte zwischen 0 und 99 als die Jahre 1400-1499 interpretiert. Verwenden Sie für alle anderen Jahreswerte die vollständige vierstellige Jahresangabe (z. B. 1520).

Abfragebeispiel

Ausdruck	Ergebnisse
SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales;	Gibt das "Datum" für das angegebene Jahr, den Monat und den Tag zurück, die in die Argumente der Funktion eingegeben wurden, und zeigt es in der Spalte "Neudatum" an. Ergebnis: "13.12.2018".

VBA-Beispiel

In diesem Beispiel wird die DateSerial-Funktion verwendet, um das Datum für das angegebene Jahr, den angegebenen Monat und den angegebenen Tag zurückzugeben.

Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.

Wählen Sie die richtige Datumsfunktion aus