Application.OnTime, méthode (Excel)Application.OnTime method (Excel)

Cette méthode programme l'exécution d'une procédure à un moment précis (soit à une heure précise soit après l'écoulement d'un délai précis).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).

SyntaxeSyntax

expression. OnTime (EarliestTime, procédure, LatestTime, planification)expression.OnTime (EarliestTime, Procedure, LatestTime, Schedule)

_expression_Une variable qui représente un objet**Application**.expression A variable that represents an Application object.

ParamètresParameters

NomName Requis/FacultatifRequired/Optional Type de donnéesData type DescriptionDescription
EarliestTimeEarliestTime ObligatoireRequired VariantVariant Heure à laquelle vous voulez que la procédure s'exécute.The time when you want this procedure to be run.
ProcedureProcedure RequisRequired StringString Nom de la procédure à exécuter.The name of the procedure to be run.
LatestTimeLatestTime FacultatifOptional VarianteVariant Toute dernière heure à laquelle la procédure peut être exécutée.The latest time at which the procedure can be run. Par exemple, si LatestTime est défini sur EarliestTime + 30 et que Microsoft Excel n'est pas en mode prêt, copie, couper ou Rechercher sur EarliestTime car une autre procédure est en cours d'exécution, Excel attendra 30 secondes la fin de la première procédure.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. Si Excel n'est pas en mode prêt dans un délai de 30 secondes, la procédure n'est pas exécutée.If Excel is not in Ready mode within 30 seconds, the procedure won't be run. Si vous ne spécifiez pas cet argument, Excel attendra jusqu'à ce que la procédure soit exécutée.If this argument is omitted, Excel will wait until the procedure can be run.
ScheduleSchedule FacultatifOptional VarianteVariant Cet argument a la valeur True pour programmer une nouvelle procédure OnTime.True to schedule a new OnTime procedure. Il a la valeur False pour effacer une procédure précédemment définie.False to clear a previously set procedure. La valeur par défaut est True.The default value is True.

RemarquesRemarks

Permet Now + TimeValue(time) de planifier une tâche à exécuter lorsqu'une durée spécifique (à partir de maintenant) s'est écoulée.Use Now + TimeValue(time) to schedule something to be run when a specific amount of time (counting from now) has elapsed. Utilisez TimeValue(time) pour programmer une procédure à exécuter à un moment précis.Use TimeValue(time) to schedule something to be run a specific time.

La valeur de EarliestTime est arrondie à la seconde la plus proche.The value of EarliestTime is rounded to the closest second.

Définissez Schedule sur false pour effacer une procédure précédemment définie avec les mêmes valeurs procedure et EarliestTime .Set Schedule to False to clear a procedure previously set with the same Procedure and EarliestTime values.

Procedure ne doit prendre aucun argument et ne peut pas être déclarée dans une classe ou un formulaire personnalisé.Procedure must take no arguments and cannot be declared in a custom class or form.

ExempleExample

Cet exemple montre comment exécuter ma_procédure 15 secondes.This example runs my_Procedure 15 seconds from now.

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

Cet exemple montre comment exécuter ma_procédure à 17 h 00.This example runs my_Procedure at 5 P.M.

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

Cet exemple montre comment annuler le paramétrage de OnTime de l'exemple précédent.This example cancels the OnTime setting from the previous example.

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

Assistance et commentairesSupport and feedback

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ?Have questions or feedback about Office VBA or this documentation? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.