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

MQL5 · Bases du langage

Dates et heures en MQL5 : datetime, TimeCurrent, MqlDateTime et fuseaux

Manipuler les dates dans un Expert Advisor : type datetime, différence entre TimeCurrent, TimeLocal et TimeGMT, comportement dans le testeur, MqlDateTime et filtres de session en heure serveur.

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

En MQL5, une date est un datetime : un entier de 8 octets qui compte les secondes écoulées depuis le 1er janvier 1970 à 00:00. Additionner 3600 ajoute une heure, soustraire deux dates donne un écart en secondes. Pour l’heure « actuelle », un Expert Advisor utilise presque toujours TimeCurrent(), l’heure du serveur de trading au dernier tick reçu, car c’est dans ce fuseau que sont horodatées les bougies. TimeLocal() (heure du PC) et TimeGMT() (heure GMT) existent aussi, mais la documentation précise que, dans le Strategy Tester, elles sont simulées à partir de l’heure du serveur : un filtre horaire bâti sur elles ne se comporte pas pareil en backtest et en réel.

Cette page fait partie de la rubrique Les bases du langage MQL5. Le type datetime est présenté parmi les autres dans Types de données en MQL5.

Le type datetime

Un datetime occupe 8 octets ; sa plage valide va du 1er janvier 1970 au 31 décembre 3000. Une constante s’écrit entre apostrophes, précédée de la lettre D : D'2024.03.15 09:30' ou D'2024.03.15 09:30:45'. La documentation accepte aussi l’ordre jour-mois-année et l’omission de l’heure (minuit). Elle recommande en revanche d’indiquer toujours l’année, le mois et le jour : une constante réduite à l’heure prend la date de compilation, avec un avertissement.

Comme il s’agit d’un entier, les calculs sont directs :

  • t + 60 : une minute plus tard ;
  • t - 86400 : vingt-quatre heures plus tôt ;
  • (t2 - t1) / 3600 : écart en heures (division entière) ;
  • t - (t % 86400) : minuit du même jour, en heure du serveur.

Les fonctions d’heure

FonctionCe qu’elle renvoieDans le Strategy Tester
TimeCurrent()Heure du serveur au dernier tick reçuSimulée à partir de l’historique
TimeTradeServer()Heure estimée du serveur, calculée par le terminalToujours égale à TimeCurrent()
TimeLocal()Heure de l’ordinateurToujours égale à TimeCurrent()
TimeGMT()Heure GMT, déduite de l’heure de l’ordinateurToujours égale à TimeTradeServer()
TimeGMTOffset()Écart en secondes entre GMT et l’heure locale—
TimeDaylightSavings()Indique si l’heure d’été est appliquée—

TimeCurrent() mérite une précision documentée : dans OnTick(), elle renvoie l’heure du tick en cours de traitement ; dans OnInit(), OnTimer() ou OnDeinit(), elle renvoie l’heure de la dernière cotation reçue pour n’importe quel symbole du Market Watch. Elle n’avance donc pas quand le marché est fermé. TimeTradeServer(), calculée côté terminal, continue d’avancer même sans tick.

Toutes ces fonctions existent en deux versions : sans paramètre, elles renvoient un datetime ; avec un paramètre MqlDateTime&, elles remplissent en plus la structure avec les composantes de la date.

Décomposer une date : MqlDateTime

La structure MqlDateTime contient huit champs de type int : year, mon, day, hour, min, sec, day_of_week (0 pour dimanche à 6 pour samedi) et day_of_year (0 pour le 1er janvier). TimeToStruct() convertit un datetime en structure, StructToTime() fait l’inverse. Pour obtenir minuit du jour courant, il suffit de remplir la structure, de mettre hour, min et sec à 0, puis de la reconvertir.

La documentation signale une subtilité de day_of_year : après février, le numéro d’un même jour calendaire diffère d’une unité entre année bissextile et non bissextile. Ne l’utilisez pas pour comparer des dates d’une année sur l’autre.

Convertir en texte et inversement

TimeToString(valeur, mode) produit une chaîne. Le mode par défaut est TIME_DATE|TIME_MINUTES (« 2024.03.15 09:30 ») ; TIME_SECONDS ajoute les secondes. StringToTime() lit notamment les formats yyyy.mm.dd hh:mi, yyyy-mm-dd hh:mi:ss ou yyyymmdd. La documentation met en garde contre certaines formes compactes ambiguës : testez les formats exotiques avant de vous y fier.

Fuseaux horaires : ce qu’il faut savoir

Chaque courtier choisit le fuseau de son serveur. Beaucoup utilisent un décalage qui place la clôture quotidienne du forex à minuit serveur, mais ce n’est pas une règle, et le décalage peut changer avec l’heure d’été. Conséquences pratiques :

  • un filtre « pas de trading entre 22 h et 1 h » n’a de sens qu’en précisant le fuseau ;
  • les bougies journalières, et donc les plus hauts et plus bas de la veille, dépendent du fuseau du serveur ;
  • un EA qui tourne chez deux courtiers différents peut prendre des décisions différentes à la même minute réelle.

En compte réel, l’écart entre le serveur et GMT peut être estimé par TimeTradeServer() - TimeGMT(). Ce calcul n’est pas valable dans le testeur, où TimeGMT() est égal à l’heure simulée du serveur. Pour un backtest, la solution la plus fiable est un paramètre input indiquant explicitement le décalage du serveur.

Exemple complet : filtre de session et de jour

//+------------------------------------------------------------------+
//| EA : filtre horaire en heure serveur, avec MqlDateTime           |
//+------------------------------------------------------------------+
input int  InpHeureDebut   = 9;     // Debut de session (heure serveur)
input int  InpHeureFin     = 17;    // Fin de session (heure serveur, exclue)
input bool InpPasLeVendredi = true; // Ne pas ouvrir le vendredi

//--- Renvoie minuit (00:00) du jour de t
datetime DebutDuJour(datetime t)
  {
   MqlDateTime s;
   TimeToStruct(t, s);
   s.hour = 0;
   s.min  = 0;
   s.sec  = 0;
   return(StructToTime(s));
  }

//--- true si l'heure serveur est dans la session autorisee
bool SessionOuverte()
  {
   MqlDateTime maint;
   TimeCurrent(maint);                       // remplit la structure (heure serveur)

   if(maint.day_of_week == 0 || maint.day_of_week == 6)
      return(false);                         // samedi ou dimanche
   if(InpPasLeVendredi && maint.day_of_week == 5)
      return(false);

   if(InpHeureDebut <= InpHeureFin)          // session dans la meme journee
      return(maint.hour >= InpHeureDebut && maint.hour < InpHeureFin);
   return(maint.hour >= InpHeureDebut || maint.hour < InpHeureFin);  // session a cheval sur minuit
  }

int OnInit()
  {
   if(!MQLInfoInteger(MQL_TESTER))
     {
      // Estimation du decalage serveur / GMT, valable uniquement en reel
      long decalage = (long)(TimeTradeServer() - TimeGMT());
      PrintFormat("Decalage estime serveur - GMT : %+.1f h", decalage / 3600.0);
     }
   return(INIT_SUCCEEDED);
  }

void OnTick()
  {
   if(!SessionOuverte())
      return;

   datetime minuit  = DebutDuJour(TimeCurrent());
   int      minutes = (int)((TimeCurrent() - minuit) / 60);   // minutes depuis 00:00 serveur
   static datetime dernierLog = 0;
   if(TimeCurrent() - dernierLog >= 3600)                   // un message par heure au plus
     {
      PrintFormat("Session ouverte, %d minutes depuis minuit serveur (%s)",
                  minutes, TimeToString(TimeCurrent(), TIME_DATE|TIME_SECONDS));
      dernierLog = TimeCurrent();
     }
  }

La fonction SessionOuverte() gère aussi les sessions à cheval sur minuit (début 22 h, fin 2 h), un cas souvent oublié. L’estimation du décalage GMT n’est faite qu’en dehors du testeur, grâce à MQLInfoInteger(MQL_TESTER). Les filtres horaires complets sont développés dans Filtres horaires, de spread et de volatilité.

Dates et bougies

Les bougies sont identifiées par leur heure d’ouverture, exprimée dans le fuseau du serveur. iTime(symbole, timeframe, decalage) renvoie l’heure d’ouverture de la bougie demandée, ou 0 en cas d’erreur ; CopyTime() remplit un tableau avec plusieurs heures d’ouverture. Ces valeurs sont la base de trois traitements courants dans un EA.

  • Détecter une nouvelle bougie : on mémorise l’heure d’ouverture de la bougie courante et l’on agit lorsqu’elle change. La méthode est détaillée dans Détecter une nouvelle bougie.
  • Détecter une nouvelle journée : on compare DebutDuJour(TimeCurrent()) à la valeur mémorisée au tick précédent. C’est le point de départ d’une limite de perte journalière ou d’une remise à zéro de compteurs.
  • Retrouver une bougie à partir d’une date : iBarShift() renvoie l’index de la bougie qui contient une date donnée, ce qui permet par exemple de lire le plus haut de la session asiatique.

Dans tous les cas, gardez à l’esprit que la « journée » est celle du serveur : une bougie D1 ne commence pas forcément à minuit dans votre fuseau.

Pièges fréquents

  • Utiliser TimeLocal() pour un filtre horaire : en backtest, elle vaut l’heure du serveur ; en réel, celle de votre PC ou de votre VPS. Le comportement diverge.
  • Oublier les week-ends : TimeCurrent() reste figée tant qu’aucun tick n’arrive. Un calcul de durée effectué le lundi matin peut inclure tout le week-end.
  • Mesurer des durées courtes avec datetime : la résolution est d’une seconde. Pour mesurer un temps d’exécution, la documentation renvoie à GetTickCount(), en millisecondes.
  • Heure d’été : le décalage entre le serveur et votre fuseau peut changer deux fois par an, et pas forcément aux mêmes dates en Europe et aux États-Unis.
  • Comparer des bougies par leur heure : utilisez iTime() ou CopyTime(), qui renvoient l’heure d’ouverture de la bougie dans le fuseau du serveur.

FAQ

Quelle fonction utiliser pour l’heure dans un EA ?

TimeCurrent(), qui renvoie l’heure du serveur au dernier tick. Elle est cohérente avec l’horodatage des bougies et elle est simulée correctement dans le Strategy Tester.

Pourquoi TimeLocal() donne-t-elle la même heure que le serveur en backtest ?

C’est le comportement documenté : pendant un test, TimeLocal() est toujours égale à l’heure simulée du serveur, et TimeGMT() à TimeTradeServer(). Les filtres fondés sur l’heure locale ou GMT ne sont donc pas testables tels quels.

Comment obtenir le jour de la semaine ?

Remplissez une structure MqlDateTime avec TimeToStruct() ou TimeCurrent(structure), puis lisez le champ day_of_week : 0 pour dimanche, 1 pour lundi, jusqu’à 6 pour samedi.

Comment ajouter un jour à une date ?

Un datetime étant un nombre de secondes, ajoutez 86400. Pour retomber sur minuit, décomposez la date avec MqlDateTime, remettez heure, minutes et secondes à zéro, puis reconvertissez avec StructToTime().

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.