DateAndTime.DateSerial(Int32, Int32, Int32) Methode

Definition

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Quelle:

DateAndTime.vb

Gibt einen Date Wert zurück, der das angegebene Jahr, den angegebenen Monat und den angegebenen Tag darstellt, wobei die Zeitinformationen auf Mitternacht (00:00:00:00) festgelegt sind.

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

Year

Int32

Erforderlich. Ganzzahliger Ausdruck zwischen 1 und 9999. Werte unterhalb dieses Bereichs werden jedoch ebenfalls akzeptiert. Wenn Year 0 bis 99 ist, wird es als zwischen 1930 und 2029 interpretiert, wie im Abschnitt "Anmerkungen" erläutert. Ist Year kleiner als 1, wird es vom aktuellen Jahr subtrahiert.

Month

Int32

Erforderlich. Ganzzahliger Ausdruck zwischen 1 und 12. Werte außerhalb dieses Bereichs werden jedoch ebenfalls akzeptiert. Der Wert von Month wird um 1 verringert und auf den Januar des berechneten Jahres angewendet. Anders ausgedrückt: (Month – 1) wird zu Januar addiert. Falls erforderlich, wird das Jahr neu berechnet. In den folgenden Ergebnissen wird dieser Effekt veranschaulicht:

Wenn Month 1 ist, ist das Ergebnis der Januar des berechneten Jahres.

Wenn Month 0 ist, ist das Ergebnis der Dezember des vorherigen Jahres.

Wenn Month -1 ist, ist das Ergebnis der November des vorherigen Jahres.

Wenn Month 13 ist, ist das Ergebnis der Januar des nächsten Jahres.

Day

Int32

Erforderlich. Ganzzahliger Ausdruck zwischen 1 und 31. Werte außerhalb dieses Bereichs werden jedoch ebenfalls akzeptiert. Der Wert von Day wird um 1 verringert und auf den ersten Tag des berechneten Monats angewendet. Anders ausgedrückt: (Day - 1) wird zum Monatsersten addiert. Falls erforderlich, werden der Monat und das Jahr neu berechnet. In den folgenden Ergebnissen wird dieser Effekt veranschaulicht:

Wenn Day 1 ist, ist das Ergebnis der erste Tag des berechneten Monats.

Wenn Day 0 ist, ist das Ergebnis der letzte Tag des vorherigen Monats.

Wenn Day -1 ist, ist das Ergebnis der vorletzte Tag des vorherigen Monats.

Wenn Day das Ende des aktuellen Monats überschreitet, ist das Ergebnis der entsprechende Tag des nächsten Monats. Wenn z. B. Month 4 ist und Day 31, dann lautet das Ergebnis 1. Mai.

Gibt zurück

DateTime

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

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 von 0 bis 29 als die Jahre 2000-2029 und Werte von 30 bis 99 als die Jahre 1930-1999 interpretiert werden. Um alle anderen Jahre zu kennzeichnen, verwenden Sie ein vierstelliges Jahr, z. B. 1924.

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

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

Wenn entweder Month oder Day seinen normalen Bereich überschreitet, wird er je nach Bedarf auf die nächst größere Einheit angewendet. Wenn Sie beispielsweise 32 Tage angeben, wird dies je nach Wert von Monthals einen Monat und von einem bis vier Tagen ausgewertet. Wenn Year 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 Fehler auf ArgumentException . Wenn das durch die drei Argumente angegebene Datum früher als 00:00:00 Uhr am 1. Januar des Jahres oder später 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 Werte auf 0 fest, sodass der zurückgegebene Wert den Beginn des berechneten Tages darstellt.

Da jeder Date Wert von einer DateTime Struktur unterstützt wird, bieten die zugehörigen Methoden zusätzliche Optionen beim Zusammenstellen eines Werts Date . Beispielsweise können Sie einen der überladenen DateTime Konstruktoren verwenden, um eine Date Variable mit der gewünschten Kombination von Komponenten aufzufüllen. Im folgenden Beispiel wird der 6. Mai 1978 um eine Zehntel 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
• Datentyp: Zusammenfassung (Visual Basic)