Nouveau : la formation trading algorithmique MQL5, MQL4 et ProRealTimeDécouvrir →

MQL4 · Bases

Fonctions de temps en MQL4 : TimeCurrent, TimeHour et filtres horaires

TimeCurrent, TimeLocal, TimeGMT, TimeHour, TimeDayOfWeek, TimeToStruct : quelle horloge utiliser dans un EA MQL4 et comment écrire un filtre de session fiable, même au passage de minuit.

Mis à jour le 23 octobre 2026Lecture : 6 minPar Alix, OptiBot Trading

Les fonctions de temps du MQL4 se répartissent en deux familles. Les premières renvoient une date : TimeCurrent() (heure du serveur de trading, celle de la dernière cotation reçue), TimeLocal() (heure de l’ordinateur) et TimeGMT() (heure GMT déduite de l’heure locale). Les secondes découpent une date : TimeHour(), TimeMinute(), TimeDayOfWeek(), TimeDay(), TimeMonth(), TimeYear(), ou en un seul appel TimeToStruct() qui remplit une structure MqlDateTime. Pour un EA, la référence à utiliser est presque toujours l’heure du serveur, car c’est elle qui horodate les bougies et les ordres.

Cette page explique quelle heure utiliser, comment écrire un filtre de session fiable (y compris quand la plage horaire passe minuit) et quels pièges guettent les robots qui dépendent de l’horloge. Elle s’inscrit dans la rubrique Les bases du MQL4.

Le type datetime

Une date MQL4 est un entier datetime qui compte les secondes écoulées depuis le 1er janvier 1970 à 00:00. Cette représentation rend les calculs très simples : ajouter une heure revient à ajouter 3600, et l’écart entre deux dates s’obtient par soustraction. Les constantes littérales s’écrivent D'2026.10.27 09:30', et la conversion vers une chaîne lisible passe par TimeToString() avec les options TIME_DATE, TIME_MINUTES et TIME_SECONDS. Le chemin inverse, d’une chaîne vers une date, se fait avec StringToTime().

Les valeurs de Time[] sont du même type : Time[0] est l’heure d’ouverture de la bougie en cours, exprimée dans l’heure du serveur. Voir [Tableaux de séries (Close[], Time[])](/mql4/bases/tableaux-de-series/).

Quelle horloge utiliser

FonctionCe qu’elle renvoieUsage conseillé
TimeCurrent()Heure du serveur à la dernière cotation reçueFiltres horaires, horodatage, comparaison avec Time[] et les dates des ordres
TimeLocal()Heure de l’ordinateur qui exécute le terminalMessages destinés à l’utilisateur, rarement la logique de trading
TimeGMT()Heure GMT calculée à partir de l’heure locale et du fuseau de la machineAligner une stratégie sur des horaires GMT (annonces économiques)

Deux particularités méritent d’être retenues. D’abord, TimeCurrent() n’avance qu’avec les cotations : pendant un week-end ou sur un symbole peu actif, elle reste figée sur le dernier tick. Ensuite, dans le testeur de stratégie, l’heure locale est simulée et coïncide avec l’heure du serveur : un filtre écrit avec TimeLocal() donnera donc en backtest des résultats différents du réel. C’est l’argument le plus fort pour construire toute la logique horaire sur TimeCurrent().

L’heure du serveur dépend du courtier. Beaucoup de serveurs ne sont pas réglés sur GMT, et certains suivent un changement d’heure d’été. Avant de paramétrer un filtre « session de Londres », observez l’heure d’ouverture des bougies journalières de votre serveur pour connaître son décalage.

Découper une date

Les fonctions TimeHour(t), TimeMinute(t), TimeDayOfWeek(t) et leurs voisines prennent un datetime en paramètre et en extraient un élément. TimeDayOfWeek() renvoie 0 pour dimanche, 1 pour lundi, jusqu’à 6 pour samedi.

Il existe aussi des versions sans paramètre : Hour(), Minute(), DayOfWeek(), Day(), Month(), Year(). Elles portent sur la dernière heure du serveur connue au début de l’exécution du programme et ne changent pas pendant cette exécution. Elles sont pratiques, mais pour un code explicite et portable, préférez passer la date en paramètre.

La méthode la plus lisible, et celle qui se transpose directement en MQL5, consiste à utiliser TimeToStruct() :

MqlDateTime dt;
TimeToStruct(TimeCurrent(), dt);
// dt.year, dt.mon, dt.day, dt.hour, dt.min, dt.sec, dt.day_of_week, dt.day_of_year
PrintFormat("Nous sommes le jour %d de la semaine, il est %02d:%02d (serveur)",
            dt.day_of_week, dt.hour, dt.min);

StructToTime() fait l’opération inverse. C’est la façon propre de construire « aujourd’hui à 08:00 » : on remplit la structure avec la date du jour, on fixe hour à 8, min et sec à 0, puis on reconvertit.

Exemple : filtre de session et fermeture du vendredi

L’EA suivant n’autorise les entrées qu’entre deux heures paramétrables, gère les plages qui passent minuit et signale l’approche de la fermeture du vendredi.

#property strict

input int InpHeureDebut   = 8;    // Début des entrées (heure serveur)
input int InpHeureFin     = 17;   // Fin des entrées (heure serveur, exclue)
input int InpHeureVendredi = 20;  // Heure limite le vendredi

//+------------------------------------------------------------------+
//| Vrai si l'heure h est dans la plage [debut, fin[                  |
//| La plage peut passer minuit (ex. 22 -> 6)                         |
//+------------------------------------------------------------------+
bool DansPlage(int h, int debut, int fin)
  {
   if(debut == fin) return(true);          // plage vide = toute la journée
   if(debut < fin)  return(h >= debut && h < fin);
   return(h >= debut || h < fin);          // plage qui passe minuit
  }

//+------------------------------------------------------------------+
//| Contrôle horaire complet                                          |
//+------------------------------------------------------------------+
bool EntreeAutorisee()
  {
   MqlDateTime dt;
   TimeToStruct(TimeCurrent(), dt);        // toujours l'heure du serveur

   if(dt.day_of_week == 0 || dt.day_of_week == 6)
      return(false);                       // pas d'entrée le week-end
   if(dt.day_of_week == 5 && dt.hour >= InpHeureVendredi)
      return(false);                       // trop proche de la fermeture
   return(DansPlage(dt.hour, InpHeureDebut, InpHeureFin));
  }

void OnTick()
  {
   if(!EntreeAutorisee())
      return;
   // ... calcul du signal et envoi d'ordre
  }

Le traitement des plages qui passent minuit est le détail que la plupart des filtres oublient : avec un début à 22 h et une fin à 6 h, la condition h >= 22 && h < 6 n’est jamais vraie. La fonction DansPlage() traite ce cas par un « ou ».

Mesurer des durées

Pour fermer un ordre après un certain temps, comparez TimeCurrent() à l’heure d’ouverture de l’ordre, lue avec OrderOpenTime() après un OrderSelect(). La différence est en secondes : TimeCurrent() - OrderOpenTime() > 4 * 3600 signifie « ouvert depuis plus de quatre heures ». Pour compter des bougies plutôt que des secondes, ce qui neutralise les week-ends, utilisez iBarShift() sur l’heure d’ouverture.

Pour mesurer la performance de votre propre code, en revanche, TimeCurrent() est trop grossière : GetTickCount() renvoie un nombre de millisecondes, bien plus adapté.

Cas d’usage : suspendre l’EA autour d’une annonce

Les publications économiques majeures provoquent des mouvements brusques, des spreads élargis et des exécutions dégradées. Beaucoup de développeurs préfèrent suspendre les entrées dans une fenêtre autour de ces horaires. MQL4 ne dispose pas d’un calendrier économique intégré : la solution la plus simple consiste à exposer en paramètre une date d’annonce (type datetime) et une marge en minutes, puis à refuser toute entrée lorsque MathAbs(TimeCurrent() - InpAnnonce) est inférieur à la marge multipliée par 60.

Deux précautions s’imposent. La date saisie doit être exprimée en heure du serveur, pas en heure de Paris ; indiquez-le clairement dans le libellé du paramètre. Ensuite, une telle fenêtre ne protège que les nouvelles entrées : les positions déjà ouvertes restent exposées au mouvement, ce qui relève de la gestion du risque et non du filtre horaire. Si votre stratégie ne doit pas rester en position pendant l’annonce, fermez explicitement avant le début de la fenêtre, avec une marge suffisante pour absorber un éventuel refus d’ordre.

Pièges fréquents

  • Mélanger les horloges. Comparer TimeLocal() à Time[0] revient à comparer deux fuseaux différents. Restez sur l’heure du serveur.
  • Croire que l’heure avance seule. Sans nouveau tick, TimeCurrent() ne change pas. Un EA qui doit agir à heure fixe même sans cotation passera par OnTimer(), tout en sachant que l’heure serveur restera celle du dernier tick.
  • Coder un décalage horaire en dur. Un « +2 heures » écrit dans le code devient faux au changement d’heure ou au changement de courtier. Exposez-le en paramètre.
  • Oublier les jours fériés et les ouvertures tardives. Le lundi matin et certains jours de fête, les premières cotations arrivent avec des spreads larges. Un filtre horaire ne remplace pas un filtre de spread.

Et en MQL5 ?

TimeCurrent(), TimeLocal(), TimeGMT(), TimeToStruct() et StructToTime() existent en MQL5 sous le même nom. En revanche, TimeHour(), TimeDayOfWeek(), Hour() ou DayOfWeek() n’y existent pas : on passe systématiquement par MqlDateTime. Écrire vos filtres avec TimeToStruct() dès le MQL4, comme dans l’exemple ci-dessus, vous évitera de les réécrire lors d’un portage. La rubrique Migration de MQL4 vers MQL5 liste les autres fonctions concernées, et la page Comptes ECN : placer les stops après l’ouverture montre un autre cas où le comportement du serveur conditionne le code.

FAQ

Quelle est la différence entre TimeCurrent et TimeLocal ?

TimeCurrent() renvoie l’heure du serveur du courtier à la dernière cotation reçue, TimeLocal() l’heure de votre ordinateur. Les bougies et les ordres sont horodatés en heure serveur : c’est elle qu’il faut utiliser dans la logique de trading.

Pourquoi mon filtre horaire fonctionne en réel mais pas en backtest ?

Le plus souvent parce qu’il repose sur TimeLocal(), qui, dans le testeur, est simulée et égale à l’heure du serveur. Réécrivez-le avec TimeCurrent().

Comment connaître le décalage entre l’heure du serveur et GMT ?

En temps réel, la différence TimeCurrent() - TimeGMT(), arrondie à l’heure, donne une estimation, à condition que l’horloge de l’ordinateur soit juste et que des cotations arrivent. Le plus fiable reste de vérifier l’information auprès du courtier et de l’exposer en paramètre.

Que renvoie TimeDayOfWeek pour le dimanche ?

0. Les valeurs vont de 0 (dimanche) à 6 (samedi), comme le champ day_of_week de MqlDateTime.

A

Alix · fondateur d’OptiBot Trading

Développeur MQL5 et ProBuilder, spécialiste du backtest et de l’optimisation de stratégies automatiques. Chaque contenu est vérifié sur la documentation officielle (MQL5.com, manuels ProRealTime) et testé avant publication. Notre méthode éditoriale.