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.