DateAndTime.TimeSerial(Int32, Int32, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt einen Date Wert zurück, der eine angegebene Stunde, Minute und Sekunde darstellt, wobei die Datumsinformationen relativ zum 1. Januar des Jahres 1 festgelegt sind.
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 -> DateTimePublic Function TimeSerial (Hour As Integer, Minute As Integer, Second As Integer) As DateTimeParameter
- Hour
- Int32
Required. Ganzzahliger Ausdruck von 0 bis 23. Werte außerhalb dieses Bereichs werden jedoch ebenfalls akzeptiert.
- Minute
- Int32
Required. Ganzzahliger Ausdruck von 0 bis 59. Werte außerhalb dieses Bereichs werden jedoch ebenfalls akzeptiert. Der Wert der Minute berechneten Stunde wird hinzugefügt, sodass ein negativer Wert Minuten vor dieser Stunde angibt.
- Second
- Int32
Required. Ganzzahliger Ausdruck von 0 bis 59. Werte außerhalb dieses Bereichs werden jedoch ebenfalls akzeptiert. Der Wert der Second berechneten Minute wird hinzugefügt, sodass ein negativer Wert Sekunden vor dieser Minute angibt.
Gibt zurück
Ein Date Wert, der eine angegebene Stunde, Minute und Sekunde darstellt, wobei die Datumsinformationen relativ zum 1. Januar des Jahres 1 festgelegt sind.
Ausnahmen
Ein Argument liegt außerhalb des Bereichs -2.147.483.648 bis 2.147.483.647
Berechnete Zeit ist weniger als negative 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 Mittag oder 8:45:00 Uhr darstellt.
Dim alarmTime As Date = TimeSerial(12 - 3, -15, 0)
Wenn der Minute normale Bereich entweder überschritten oder Second überschritten wird, wird er je nach Bedarf auf die nächste größere Einheit angewendet. Wenn Sie beispielsweise 75 Minuten angeben, wird dieser Wert zu einer Stunde und 15 Minuten ausgewertet.
TimeSerial reduziert das Gesamt sekundenmodulo 86.400, also die Anzahl der Sekunden pro Tag. Daher liegt die zurückgegebene Uhrzeit immer zwischen 00:00:00 und 23:59:59 Uhr.
Der Date Datentyp enthält Datumskomponenten.
TimeSerial legt alle diese 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 sich die Werte und HourMinute führen zu einer kombinierten 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 Uhrzeit führen, werden die Datumsinformationen auf 1/1/0001 festgelegt, und die Uhrzeitinformationen werden so angepasst, dass sie zwischen 00:00:00 und 23:59:59 uhr 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 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)