Application.OnTime-Methode (Excel)

Bewirkt, dass eine Prozedur zu einem bestimmten Zeitpunkt in der Zukunft (entweder zu einer bestimmten Zeit oder nachdem eine bestimmte Zeitspanne vergangen ist) ausgeführt wird.

Syntax

Ausdruck verwendet werden. OnTime (EarliestTime, Procedure, LatestTime, Schedule)

expression Eine Variable, die ein Application-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
EarliestTime Erforderlich Variant Die Zeit, zu der diese Prozedur ausgeführt werden soll.
Procedure Erforderlich String Der Name der auszuführenden Prozedur.
LatestTime Optional Variant Der späteste Zeitpunkt zum Ausführen der Prozedur. Wenn z. B. "LatestTime " auf "Frühestezeit +30" festgelegt ist und sich Microsoft Excel zum frühesten Zeitpunkt nicht im Modus "Bereit", "Kopieren", "Ausschneiden" oder "Suchen" befindet, weil eine andere Prozedur ausgeführt wird, wartet Excel 30 Sekunden, bis die erste Prozedur abgeschlossen ist. Wenn sich Excel nicht innerhalb von 30 Sekunden im Bereitschaftsmodus befindet, wird die Prozedur nicht ausgeführt. Wenn Sie dieses Argument auslassen, wartet Excel, bis die Prozedur ausgeführt werden kann.
Schedule Optional Variant Beim Wert True wird eine neue "OnTime"-Prozedur ausgeführt. Beim Wert False wird eine zuvor festgelegte Prozedur gelöscht. Der Standardwert ist True.

Hinweise

Wird verwendet Now + TimeValue(time) , um etwas zu planen, das nach Ablauf einer bestimmten Zeitspanne (ab jetzt gerechnet) ausgeführt werden soll. Verwenden Sie TimeValue(time) zum Ausführen eines Programms o. ä. für eine bestimmte Zeit.

Der Wert von "Frühestzeit" wird auf die nächste Sekunde gerundet.

Legen Sie Zeitplan auf "Falsch" fest, um eine Prozedur zu löschen, die zuvor mit denselben Prozedur- und EarliestTime-Werten festgelegt wurde.

Prozedur darf keine Argumente verwenden und kann nicht in einer benutzerdefinierten Klasse oder einem Formular deklariert werden.

Beispiel

Dieses Beispiel wird my_Procedure 15 Sekunden ab jetzt ausgeführt.

Application.OnTime Now + TimeValue("00:00:15"), "my_Procedure"

Dieses Beispiel läuft my_Procedure um 17 Uhr.

Application.OnTime TimeValue("17:00:00"), "my_Procedure"

In diesem Beispiel wird die OnTime-Einstellung aus dem vorherigen Beispiel gelöscht.

Application.OnTime EarliestTime:=TimeValue("17:00:00"), _ 
 Procedure:="my_Procedure", Schedule:=False

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.