Application.OnTime-Methode (Excel)Application.OnTime method (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.Schedules a procedure to be run at a specified time in the future (either at a specific time of day or after a specific amount of time has passed).

SyntaxSyntax

Ausdruck. OnTime (Frühestens, Prozedur, _Letzte_Zeit, Terminplan)expression.OnTime (EarliestTime, Procedure, LatestTime, Schedule)

expression Eine Variable, die ein Application-Objekt darstellt.expression A variable that represents an Application object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
EarliestTimeEarliestTime ErforderlichRequired VariantVariant Die Zeit, zu der diese Prozedur ausgeführt werden soll.The time when you want this procedure to be run.
ProcedureProcedure ErforderlichRequired StringString Der Name der auszuführenden Prozedur.The name of the procedure to be run.
LatestTimeLatestTime OptionalOptional VariantVariant Der späteste Zeitpunkt zum Ausführen der Prozedur.The latest time at which the procedure can be run. Wenn beispielsweise der Wert für die neueste Zeit auf früh zeitig + 30 festgelegt ist und Microsoft Excel zum frühestmöglichen Zeitpunkt nicht im Modus bereit, kopieren, Ausschneiden oder suchen ist, weil eine andere Prozedur ausgeführt wird, wartet Excel 30 Sekunden, bis die erste Prozedur abgeschlossen ist.For example, if LatestTime is set to EarliestTime + 30 and Microsoft Excel is not in Ready, Copy, Cut, or Find mode at EarliestTime because another procedure is running, Excel will wait 30 seconds for the first procedure to complete. Wenn sich Excel innerhalb von 30 Sekunden nicht im Bereitschaftsmodus befindet, wird die Prozedur nicht ausgeführt.If Excel is not in Ready mode within 30 seconds, the procedure won't be run. Wenn dieses Argument ausgelassen wird, wartet Excel, bis die Prozedur ausgeführt werden kann.If this argument is omitted, Excel will wait until the procedure can be run.
ScheduleSchedule OptionalOptional VariantVariant Beim Wert True wird eine neue "OnTime"-Prozedur ausgeführt.True to schedule a new OnTime procedure. Beim Wert False wird eine zuvor festgelegte Prozedur gelöscht.False to clear a previously set procedure. Der Standardwert ist True.The default value is True.

HinweiseRemarks

Verwenden Now + TimeValue(time) Sie, um zu planen, dass etwas ausgeführt wird, wenn eine bestimmte Zeitspanne (gerechnet ab jetzt) abgelaufen ist.Use Now + TimeValue(time) to schedule something to be run when a specific amount of time (counting from now) has elapsed. Verwenden Sie TimeValue(time) zum Ausführen eines Programms o. ä. für eine bestimmte Zeit.Use TimeValue(time) to schedule something to be run a specific time.

Der Wert früh zeitig wird auf die nächste Sekunde gerundet.The value of EarliestTime is rounded to the closest second.

Legen Sie Schedule auf false fest, um eine Prozedur zu löschen, die zuvor mit denselben Werten für Procedure und frühestens festgelegt wurde.Set Schedule to False to clear a procedure previously set with the same Procedure and EarliestTime values.

Prozedur darf keine Argumente verwenden und kann nicht in einer benutzerdefinierten Klasse oder einem Formular deklariert werden.Procedure must take no arguments and cannot be declared in a custom class or form.

BeispielExample

In diesem Beispiel wird_meine Prozedur 15 Sekunden lang ausgeführt.This example runs my_Procedure 15 seconds from now.

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

In diesem Beispiel wird_meine Prozedur um 17.00 Uhr ausgeführt.This example runs my_Procedure at 5 P.M.

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

In diesem Beispiel wird die OnTime-Einstellung aus dem vorherigen Beispiel gelöscht.This example cancels the OnTime setting from the previous example.

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

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.