Freigeben über


TimeSerial-Funktion

Gibt einen Variant-Wert (Date) zurück, der die Uhrzeit mit einer bestimmten Stunde, Minute und Sekunde enthält.

Syntax

TimeSerial(hour, minute, second)

Die Syntax der TimeSerial-Funktion enthält die folgenden benannten Argumente:

Bestandteil Beschreibung
hour Erforderlich; Variant (Integer). Eine Zahl zwischen 0 (0:00 Uhr) und 23 (23:00 Uhr) (einschließlich) oder ein numerischer Ausdruck.
minute Erforderlich; Variant (Integer). Ein beliebiger numerischer Ausdruck.
second Erforderlich; Variant (Integer). Jeder numerischer Ausdruck.

Hinweise

Um eine Uhrzeit anzugeben, z. B. 11:59:59, sollte der Zahlenbereich für jedes TimeSerial-Argument im normalen Bereich für die Einheit liegen. d. h. 0–23 für Stunden und 0–59 für Minuten und Sekunden. Sie können jedoch auch relative Zeiten für jedes Argument angeben, indem Sie einen beliebigen numerischen Ausdruck verwenden, der eine bestimmte Anzahl von Stunden, Minuten oder Sekunden vor oder nach einer bestimmten Zeit darstellt.

Im folgenden Beispiel werden Ausdrücke anstelle von absoluten Zeitzahlen verwendet. Die TimeSerial-Funktion gibt eine Zeit für 15 Minuten vor (-15) sechs Stunden vor Mittag (12 - 6) oder 5:45:00 Uhr zurück.

TimeSerial(12 - 6, -15, 0)

Wenn ein Argument außerhalb des normalen Bereichs für dieses Argument liegt, wird es auf die nächst höhere Einheit angehoben. Wenn Sie beispielsweise 75 Minuten angeben, wird dies als 1 Stunde und 15 Minuten ausgewertet. Wenn eines der Argumente außerhalb des Bereichs zwischen -32.768 und 32.767 liegt, tritt ein Fehler auf. Wenn die durch die drei Argumente angegebene Zeit zu einem Datum außerhalb des gültigen Datumsbereichs liegt, tritt ein Fehler auf.

Beispiel

In diesem Beispiel wird mit der TimeSerial-Funktion eine Uhrzeit entsprechen der angegebenen Stunde, Minute und Sekunde zurückgegeben.

Dim MyTime
MyTime = TimeSerial(16, 35, 17)    ' MyTime contains serial 
    ' representation of 4:35:17 PM.

Siehe auch

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.