MQL5 · Expert Advisors
Utiliser OnTimer dans un Expert Advisor MQL5 : EventSetTimer et tâches périodiques
Déclencher des traitements à intervalle régulier dans un EA MQL5, même sans tick, avec EventSetTimer, EventSetMillisecondTimer et EventKillTimer : règles de fonctionnement, exemple multi-tâches et pièges courants.
OnTimer est la fonction qu’un Expert Advisor MQL5 exécute à intervalle régulier, indépendamment de l’arrivée des ticks. Pour l’activer, appelez EventSetTimer(secondes) dans OnInit (ou EventSetMillisecondTimer(millisecondes) pour une période inférieure à la seconde), écrivez votre traitement dans void OnTimer(), puis arrêtez la minuterie avec EventKillTimer() dans OnDeinit. La minuterie sert aux tâches qui ne doivent pas dépendre de l’activité du marché : surveillance de plusieurs symboles, contrôles de sécurité, sauvegarde d’état, rapports périodiques.
Cette page de la rubrique Construire un Expert Advisor en MQL5 explique les règles de fonctionnement de la minuterie, montre comment faire cohabiter plusieurs tâches périodiques avec une seule minuterie, et liste les pièges courants. La liste complète des fonctions événementielles est présentée dans Les fonctions événementielles.
Les fonctions de la minuterie
| Fonction | Signature | Rôle |
|---|---|---|
EventSetTimer | bool EventSetTimer(int seconds) | lance une minuterie dont la période est exprimée en secondes |
EventSetMillisecondTimer | bool EventSetMillisecondTimer(int milliseconds) | lance une minuterie dont la période est exprimée en millisecondes |
EventKillTimer | void EventKillTimer() | arrête la minuterie du programme |
OnTimer | void OnTimer() | fonction appelée à chaque échéance |
Les deux fonctions de lancement renvoient true en cas de succès et false en cas d’échec ; GetLastError() donne alors la cause. Un EA qui dépend de la minuterie doit vérifier ce retour dans OnInit et refuser de démarrer si la minuterie n’a pas pu être créée.
Les règles à connaître
Une seule minuterie par programme
Chaque EA ou indicateur dispose de sa propre minuterie et ne reçoit que ses propres événements. En revanche, un programme ne peut faire tourner qu’une seule minuterie à la fois. Si vous avez besoin de tâches à des rythmes différents (toutes les secondes, toutes les minutes, toutes les heures), utilisez une minuterie au rythme le plus rapide et des compteurs ou des dates de dernière exécution pour cadencer les tâches plus lentes, comme dans l’exemple ci-dessous.
Les événements ne s’accumulent pas
Si un événement de minuterie est déjà en file d’attente ou en cours de traitement, le terminal n’en ajoute pas un nouveau. Conséquence : si OnTimer dure plus longtemps que la période, des échéances sont simplement sautées. Ne comptez donc pas les appels pour mesurer le temps écoulé ; comparez plutôt des dates.
La résolution est limitée
En temps réel, les événements de minuterie ne peuvent pas être générés plus souvent qu’une fois toutes les 10 à 16 millisecondes, en raison de limites matérielles. Une minuterie à 1 milliseconde ne fonctionnera donc pas à ce rythme. Pour la quasi-totalité des EA, une période d’une seconde ou plus suffit.
La minuterie est détruite à l’arrêt
Si l’EA s’arrête sans avoir appelé EventKillTimer, le terminal détruit la minuterie. Appeler explicitement EventKillTimer dans OnDeinit reste une bonne pratique : le code exprime clairement son cycle de vie, et la règle est indispensable si la minuterie est lancée dans le constructeur d’une classe (arrêtez-la alors dans le destructeur).
Le temps dans OnTimer
TimeCurrent() renvoie l’heure du dernier tick connu. Lorsque le marché est fermé ou très calme, cette valeur n’avance plus, alors que OnTimer continue d’être appelé. Pour cadencer des tâches, utilisez une horloge qui avance toujours, comme TimeLocal() (heure de l’ordinateur) ou TimeTradeServer() (heure estimée du serveur). Les différences entre ces fonctions sont expliquées dans Dates, heures et fuseaux.
Exemple : plusieurs tâches avec une seule minuterie
L’EA ci-dessous lance une minuterie d’une seconde. Toutes les secondes, il vérifie la connexion ; toutes les minutes, il contrôle que des cotations arrivent ; toutes les heures, il écrit un bilan dans le journal.
#property version "1.00"
input int InpStaleSeconds = 120; // délai sans tick au-delà duquel on s'inquiète
datetime g_lastMinuteTask = 0;
datetime g_lastHourTask = 0;
bool g_wasConnected = true;
int OnInit()
{
if(!EventSetTimer(1)) // une échéance par seconde
{
Print("Minuterie impossible, erreur ", GetLastError());
return(INIT_FAILED);
}
return(INIT_SUCCEEDED);
}
void OnDeinit(const int reason)
{
EventKillTimer(); // arrêt explicite de la minuterie
}
void OnTimer()
{
datetime now = TimeLocal(); // horloge qui avance même sans tick
//--- tâche 1 (chaque seconde) : changement d'état de la connexion
bool connected = (bool)TerminalInfoInteger(TERMINAL_CONNECTED);
if(connected != g_wasConnected)
{
Print(connected ? "Connexion rétablie" : "Connexion au serveur perdue");
g_wasConnected = connected;
}
//--- tâche 2 (chaque minute) : les cotations arrivent-elles ?
if(now - g_lastMinuteTask >= 60)
{
g_lastMinuteTask = now;
MqlTick tick;
if(SymbolInfoTick(_Symbol, tick))
{
long age = (long)(TimeTradeServer() - tick.time);
if(age > InpStaleSeconds)
PrintFormat("%s : aucun tick depuis %I64d s (marché fermé ou flux interrompu)", _Symbol, age);
}
}
//--- tâche 3 (chaque heure) : bilan dans le journal
if(now - g_lastHourTask >= 3600)
{
g_lastHourTask = now;
PrintFormat("Bilan : capitaux propres %.2f, positions ouvertes %d",
AccountInfoDouble(ACCOUNT_EQUITY), PositionsTotal());
}
}
void OnTick()
{
//--- la logique de trading reste ici, déclenchée par les ticks
}
Lecture du code
- Une seule minuterie, trois rythmes : chaque tâche lente mémorise la date de sa dernière exécution et compare l’écart à sa période.
- Les dates sont initialisées à 0 : les tâches 2 et 3 s’exécutent donc dès la première seconde, ce qui permet de vérifier immédiatement leur bon fonctionnement.
- La logique de trading reste dans
OnTick. Rien n’interdit de trader depuisOnTimer(c’est le cas des EA multi-symboles), mais séparer la surveillance de la décision rend l’EA plus lisible.
OnTimer et OnTick dans le même EA
Chaque programme possède sa propre file d’événements, traitée dans l’ordre d’arrivée : OnTick et OnTimer ne s’exécutent jamais en même temps dans un même EA. Vous n’avez donc pas à protéger les variables globales contre des accès simultanés entre ces deux fonctions. En contrepartie, un traitement long dans l’une retarde l’autre. Si OnTimer et OnTick partagent une décision (par exemple un drapeau « trading suspendu »), écrivez-la dans une variable globale lue par les deux : c’est simple et sans risque de conflit.
Cas d’usage en trading
- EA multi-symboles : parcourir la liste des instruments et détecter les nouvelles bougies de chacun, sans dépendre des ticks du graphique. Voir EA multi-symboles.
- Gestion à heure fixe : fermer les positions avant le week-end ou avant la clôture d’un indice, même si aucun tick n’arrive au moment voulu.
- Sauvegarde périodique : écrire l’état de l’EA sur disque toutes les minutes, comme décrit dans Sauvegarder l’état dans des fichiers.
- Surveillance : contrôler la connexion, l’âge des cotations, l’autorisation de trading, et prévenir l’opérateur en cas d’anomalie.
- Rafraîchissement d’interface : mettre à jour un panneau d’informations à un rythme fixe plutôt qu’à chaque tick.
Pièges fréquents
- Oublier de vérifier le retour d’EventSetTimer. Sans minuterie, un EA multi-symboles ne fait plus rien, sans aucun message.
- Utiliser TimeCurrent pour cadencer. Le week-end,
TimeCurrent()reste figé sur le dernier tick du vendredi : une tâche horaire basée sur cette valeur ne s’exécute plus. - Un traitement trop long. Un
OnTimerqui parcourt tout l’historique du compte chaque seconde ralentit le terminal et retarde aussi le traitement des ticks, puisque les événements d’un même programme sont traités l’un après l’autre. - Une période trop courte dans le Strategy Tester. Le testeur appelle
OnTimerselon la période demandée : une minuterie rapide augmente nettement la durée des tests. Adaptez la période si le traitement ne nécessite pas une telle fréquence. - Appeler EventSetTimer deux fois. Il n’existe qu’une minuterie par programme : un second appel ne crée pas une seconde minuterie. Concevez dès le départ une minuterie unique cadençant plusieurs tâches.
Questions fréquentes
OnTimer est-il appelé quand le marché est fermé ?
Oui, tant que le terminal tourne et que l’EA est actif, la minuterie continue de générer des événements, même sans tick. C’est justement ce qui la rend utile pour la surveillance.
Peut-on changer la période de la minuterie en cours de route ?
Oui : arrêtez la minuterie avec EventKillTimer, puis relancez-la avec la nouvelle période. Gardez cependant à l’esprit qu’il n’existe qu’une minuterie par programme.
OnTimer fonctionne-t-il dans le Strategy Tester ?
Oui. Le testeur génère les événements de minuterie selon le temps simulé. Plus la période est courte, plus le test est long, car OnTimer est appelé plus souvent.
Faut-il préférer OnTimer à OnTick pour un EA mono-symbole ?
Pas forcément. Pour une stratégie qui réagit aux prix d’un seul instrument, OnTick est le déclencheur naturel. La minuterie est utile en complément, pour les tâches qui doivent s’exécuter même sans tick.
- Structure d’un Expert Advisor
- Détecter une nouvelle bougie
- Coder un signal d’entrée
- Filtres horaires, de spread et de volatilité
- Intégrer la gestion du risque
- Limite de perte journalière
- EA multi-symboles
- Variables globales du terminal
- Sauvegarder l’état dans des fichiers
- Alertes, e-mails et notifications push
- Panneaux et boutons (CAppDialog)
- L’assistant MQL5 (MQL5 Wizard)
- Déployer un EA sur VPS
- Checklist avant mise en production
