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 (einschließlich) oder ein numerischer Ausdruck. |
| Monat | Erforderlich. Integer. Beliebiger numerischer Ausdruck. |
| Tag | Erforderlich. Integer. Beliebiger numerischer Ausdruck. |
Hinweise
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 Datumsangaben für jedes Argument angeben, indem Sie einen beliebigen numerischen Ausdruck verwenden, der eine Bestimmte Anzahl von Tagen, Monaten oder Jahren vor oder nach einem bestimmten Datum darstellt.
Im folgenden Beispiel werden numerische Ausdrücke anstelle absoluter Datumszahlen verwendet. Hier gibt die DateSerial-Funktion ein Datum zurück, das dem Tag vor dem ersten Tag (1 - 1), zwei Monate vor August (8 - 2), 10 Jahren vor 1990 () entspricht.1990 - 10 Mit anderen Worten: 31. Mai 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Zweistellige Jahre für das Argument Year 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 ein vierstelliges Jahr (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.
Hinweis
Wenn die einstellung der Calendar Eigenschaft für Jahr,Monat und Tag gregorianisch ist, wird davon ausgegangen, dass der angegebene Wert gregorianisch ist. Ist die Calendar-Eigenschaft auf Hijri festgelegt, wird der jeweils angegeben Wert als Wert des Hijri-Kalender interpretiert.
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 Year werden Werte zwischen 0 und 99 (einschließlich) als die Jahre 1400-1499 interpretiert. Verwenden Sie für alle anderen Jahreswerte das vollständige vierstellige Jahr (z. B. 1520).
Abfragebeispiel
| Ausdruck | Ergebnisse |
|---|---|
| SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales; | Gibt das "Datum" für das angegebene Jahr, den angegebenen Monat und den angegebenen Tag zurück, die in den Argumenten der Funktion eingegeben wurden, und wird in der Spalte "NewDate" angezeigt. Ergebnis: "13/12/2018". |
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 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.