DateAndTime.DateSerial(Int32, Int32, Int32) Methode

public:
 static DateTime DateSerial(int Year, int Month, int Day);

public static DateTime DateSerial(int Year, int Month, int Day);

static member DateSerial : int * int * int -> DateTime

Public Function DateSerial (Year As Integer, Month As Integer, Day As Integer) As DateTime

Parameter

Gibt zurück

Ein Wert, der das angegebene Jahr, den Angegebenen Monat und den Tag darstellt, wobei die Zeitinformationen auf Mitternacht festgelegt sind (00:00:00).

Beispiele

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.

' DateSerial returns the date for a specified year, month, and day.
Dim aDate As Date
' Variable aDate contains the date for February 12, 1969.
aDate = DateSerial(1969, 2, 12)
Console.WriteLine(aDate)

' The following example uses DateSerial to determine and display
' the last day of the previous month.
' First, establish a starting date.
Dim startDate = #1/23/1994#
' The 0 for the day represents the last day of the previous month.
Dim endOfLastMonth = DateSerial(startDate.Year, startDate.Month, 0)
Console.WriteLine("Last day in the previous month: " & endOfLastMonth)

' The following example finds and displays the day of the week that the 
' 15th day of the following month will fall on.
Dim fifteenthsDay = DateSerial(Today.Year, Today.Month + 1, 15)
Console.WriteLine("The 15th of next month is a {0}", fifteenthsDay.DayOfWeek)

Hinweise

Zweistellige Werte für das Year Argument werden basierend auf benutzerdefinierten Computereinstellungen interpretiert. Die Standardeinstellungen sind, dass Werte zwischen 0 und 29 als die Jahre 2000-2029 interpretiert werden und Werte zwischen 30 und 99 als die Jahre 1930-1999 interpretiert werden. Um alle anderen Jahre zu kennzeichnen, verwenden Sie beispielsweise ein vierstelliges Jahr, z. B. 1924.

Im folgenden Beispiel werden negative, Null- und positive Argumentwerte veranschaulicht. Hier gibt die DateSerial Funktion einen Date Tag vor dem ersten März im Jahr 10 Jahre vor dem aktuellen Jahr zurück, d. h. vor zehn Jahren den letzten Tag des Februars.

Dim EndFeb As Date = DateSerial(-10, 3, 0)

Wenn der Month normale Bereich entweder überschritten oder Day überschritten wird, wird er je nach Bedarf auf die nächste größere Einheit angewendet. Wenn Sie beispielsweise 32 Tage angeben, wird sie je nach Wert Monthvon 32 Tagen als monat und von 1 bis vier Tagen ausgewertet. Wenn Year ein Argument größer als 9999 ist oder sich ein Argument außerhalb des Bereichs -2.147.483.648 bis 2.147.483.647 befindet, tritt ein ArgumentException Fehler auf. Wenn das durch die drei Argumente angegebene Datum vor 00:00:00 Uhr am 1. Januar oder höher als 23:59:59 Uhr am 31. Dezember 9999 liegt, tritt ein ArgumentOutOfRangeException Fehler auf.

Der Date Datentyp enthält Zeitkomponenten. DateSerial legt alle diese auf 0 fest, sodass der zurückgegebene Wert den Anfang des berechneten Tages darstellt.

Da jeder Date Wert von einer DateTime Struktur unterstützt wird, bieten die Methoden zusätzliche Optionen beim Zusammenstellen eines Date Werts. Sie können beispielsweise einen der überladenen DateTime Konstruktoren verwenden, um eine Date Variable mithilfe der gewünschten Kombination von Komponenten aufzufüllen. Im folgenden Beispiel wird der 6. Mai 1978 um ein Zehntel einer Sekunde vor 8:30 Uhr morgens festgelegt NewDateTime :

Dim NewDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)

Weitere Informationen

• DateValue(String)
• Day(DateTime)
• Month(DateTime)
• Now
• TimeSerial(Int32, Int32, Int32)
• TimeValue(String)
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• System
• Zusammenfassung des Datentyps (Visual Basic)