Application.OnTime, méthode (Excel)

Article
04/07/2023

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).

Syntaxe

expression. OnTime (EarliestTime, Procedure, LatestTime, Schedule)

expressionUne variable qui représente un objetApplication.

Paramètres

Nom	Requis/Facultatif	Type de données	Description
EarliestTime	Obligatoire	Variante	Heure à laquelle vous voulez que la procédure s'exécute.
Procedure	Obligatoire	Chaîne	Nom de la procédure à exécuter.
LatestTime	Facultatif	Variant	Toute dernière heure à laquelle la procédure peut être exécutée. Par exemple, si LatestTime est défini sur EarliestTime + 30 et que Microsoft Excel n’est pas en mode Prêt, Copier, Couper ou Rechercher au moment de l’heure, car une autre procédure est en cours d’exécution, Excel attend 30 secondes pour que la première procédure se termine. Si Excel n’est pas en mode Prêt dans les 30 secondes, la procédure n’est pas exécutée. Si cet argument est omis, Excel attend que la procédure puisse être exécutée.
Schedule	Facultatif	Variant	Cet argument a la valeur True pour programmer une nouvelle procédure OnTime. Il a la valeur False pour effacer une procédure précédemment définie. La valeur par défaut est True.

Remarques

Permet Now + TimeValue(time) de planifier l’exécution d’un élément lorsqu’un délai spécifique (à compter à partir de maintenant) s’est écoulé. Utilisez TimeValue(time) pour programmer une procédure à exécuter à un moment précis.

La valeur de EarliestTime est arrondie à la seconde la plus proche.

Définissez Schedule sur False pour effacer une procédure précédemment définie avec les mêmes valeurs Procedure et EarliestTime .

Procedure ne doit prendre aucun argument et ne peut pas être déclarée dans une classe ou un formulaire personnalisé.

Exemple

Cet exemple s’exécute my_Procedure dans 15 secondes.

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

Cet exemple s’exécute my_Procedure à 17 h.

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

Cet exemple montre comment annuler le paramétrage de OnTime de l'exemple précédent.

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

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette 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.