DateAndTime.TimeSerial(Int32, Int32, Int32) Methode

Definition

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Quelle:

DateAndTime.vb

Gibt einen Date-Wert zurück, der eine bestimmte Stunde, Minute und Sekunde angibt und dessen Datum der 1. Januar des Jahres 1 ist.

public:
 static DateTime TimeSerial(int Hour, int Minute, int Second);

public static DateTime TimeSerial (int Hour, int Minute, int Second);

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

Public Function TimeSerial (Hour As Integer, Minute As Integer, Second As Integer) As DateTime

Parameter

Hour

Int32

Erforderlich. Ganzzahliger Ausdruck zwischen 0 und 23. Werte außerhalb dieses Bereichs werden jedoch ebenfalls akzeptiert.

Minute

Int32

Erforderlich. Ganzzahliger Ausdruck zwischen 0 und 59. Werte außerhalb dieses Bereichs werden jedoch ebenfalls akzeptiert. Der Wert von Minute wird zu der berechneten Stunde addiert, sodass ein negativer Wert Minuten vor dieser Stunde angibt.

Second

Int32

Erforderlich. Ganzzahliger Ausdruck zwischen 0 und 59. Werte außerhalb dieses Bereichs werden jedoch ebenfalls akzeptiert. Der Wert von Second wird zu der berechneten Minute addiert, sodass ein negativer Wert Sekunden vor dieser Minute angibt.

Gibt zurück

DateTime

Ein Date-Wert, der eine bestimmte Stunde, Minute und Sekunde angibt und dessen Datum der 1. Januar des Jahres 1 ist.

Ausnahmen

ArgumentException

Ein Argument liegt nicht im Bereich zwischen –2.147.483.648 und 2.147.483.647

ArgumentOutOfRangeException

Errechnete Zeit ist kleiner als der Wert für –24 Stunden

Beispiele

Im folgenden Beispiel wird die TimeSerial -Funktion verwendet, um eine Uhrzeit für die angegebene Stunde, Minute und Sekunde zurückzugeben.

Dim thisTime As Date
thisTime = TimeSerial(16, 35, 17)

Hinweise

Im folgenden Beispiel werden negative, null und positive Argumentwerte veranschaulicht. Die TimeSerial Funktion gibt eine Zeit zurück, die 15 Minuten vor drei Stunden vor Mittag oder 8:45:00 Uhr darstellt.

Dim alarmTime As Date = TimeSerial(12 - 3, -15, 0)  

Wenn entweder Minute oder Second den normalen Bereich überschreitet, wird er je nach Bedarf auf die nächstgrößere Einheit angewendet. Wenn Sie beispielsweise 75 Minuten angeben, wird dies als eine Stunde und 15 Minuten ausgewertet.

TimeSerial reduziert die Gesamtzahl der Sekunden modulo 86.400, d. h. die Anzahl der Sekunden pro Tag. Daher liegt die zurückgegebene Zeit immer zwischen 00:00:00 und 23:59:59.

Der Date Datentyp enthält Datumskomponenten. TimeSerial legt alle diese Werte auf 1 fest, sodass der zurückgegebene Wert den ersten Tag des Jahres 1 darstellt. Wenn die Werte der Argumente jedoch dazu führen, dass die berechnete Zeit 24 Stunden überschreitet, wird der Tag bei Bedarf erhöht. Im folgenden Beispiel ergeben die Werte von Hour und Minute eine kombinierte Zeit von mehr als 24 Stunden.

MsgBox(TimeSerial(23, 75, 0))   
' The preceding statement displays "1/2/0001 12:15:00 AM".  

Wenn die Werte der Argumente zu einer negativen berechneten Zeit führen, werden die Datumsinformationen auf 1/1/0001 festgelegt, und die Zeitinformationen werden so angepasst, dass sie zwischen 00:00:00 und 23:59:59 liegt. Wenn die berechnete Zeit jedoch kleiner als negative 24 Stunden ist, tritt ein ArgumentOutOfRangeException Fehler auf.

Da jeder Date Wert von einer System.DateTime -Struktur unterstützt wird, bieten die zugehörigen Methoden zusätzliche Optionen beim Zusammenstellen eines Date Werts. Sie können beispielsweise einen der überladenen DateTime Konstruktoren verwenden, um eine Date Variable mit der gewünschten Komponentenkombination aufzufüllen. Im folgenden Beispiel wird auf den 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

• DateSerial(Int32, Int32, Int32)
• DateValue(String)
• Hour(DateTime)
• Minute(DateTime)
• Now
• Second(DateTime)
• TimeValue(String)