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

ProRealTime · ProBuilder

TIMEFRAME en ProBuilder : calculer sur plusieurs unités de temps

Utiliser TIMEFRAME pour lire une unité de temps supérieure en ProBuilder : syntaxe, modes DEFAULT et UPDATEONCLOSE, règles de multiples, limites et filtre de tendance journalier commenté.

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

L’instruction TIMEFRAME permet à un code ProBuilder de calculer des valeurs dans une unité de temps supérieure à celle du graphique. On écrit TIMEFRAME(1 hour) : toutes les lignes qui suivent sont calculées sur des bougies d’une heure, jusqu’à TIMEFRAME(DEFAULT), qui ramène le calcul à l’unité du graphique. Un second paramètre facultatif choisit le mode de mise à jour : DEFAULT, qui recalcule à chaque nouveau prix, ou UPDATEONCLOSE, qui ne recalcule qu’à la clôture de la bougie de l’unité supérieure. Une règle essentielle : l’unité demandée doit être un multiple de celle du graphique.

Cette page explique la syntaxe, les deux modes, les règles et limites documentées, et la façon d’éviter les signaux qui changent en cours de bougie. Elle fait partie de la rubrique Le langage ProBuilder.

Pourquoi utiliser plusieurs unités de temps

L’analyse multi-unités de temps est une méthode classique : on identifie la tendance de fond sur une unité longue (journalière, quatre heures) et on cherche le moment d’intervenir sur une unité courte. Sans TIMEFRAME, il faudrait approximer une moyenne journalière en multipliant la période sur un graphique horaire, ce qui ne donne pas le même résultat, notamment à cause des heures de séance. TIMEFRAME calcule directement sur les vraies bougies de l’unité supérieure.

Syntaxe

TIMEFRAME(1 hour)                      // les lignes suivantes sont calculées en 1 heure
mmHoraire = Average[20](Close)

TIMEFRAME(DEFAULT)                     // retour à l'unité du graphique
mm = Average[20](Close)

L’unité s’exprime sous la forme d’un nombre suivi d’une unité (x seconds, x minutes, x hours, x days) ou d’un mot-clé comme hourly, daily, weekly ou monthly, selon la documentation des instructions. Tant qu’aucun TIMEFRAME n’est écrit, le code s’exécute dans l’unité du graphique ; dès qu’un TIMEFRAME apparaît, il s’applique à toutes les lignes suivantes jusqu’au prochain.

Les deux modes de mise à jour

ModeComportement
DEFAULT (mode par défaut si le second paramètre est omis)le calcul de l’unité supérieure est refait à chaque nouveau prix de l’unité du graphique ; la bougie supérieure en cours de formation est prise en compte
UPDATEONCLOSEle calcul n’est refait qu’à la clôture de la bougie de l’unité supérieure ; seules des bougies terminées sont utilisées

La documentation officielle illustre la différence avec un prix moyen (Open + Close) / 2 calculé en une heure sur un graphique en 5 minutes : en mode DEFAULT, la courbe évolue à chaque bougie de 5 minutes ; en mode UPDATEONCLOSE, elle ne change qu’une fois par heure.

TIMEFRAME(1 hour)
prixMoyenDefault = (Open + Close) / 2              // évolue à chaque bougie du graphique

TIMEFRAME(1 hour, UPDATEONCLOSE)
prixMoyenClos = (Open + Close) / 2                 // ne change qu'à la clôture de chaque heure

TIMEFRAME(DEFAULT)
RETURN prixMoyenDefault AS "Mode DEFAULT", prixMoyenClos AS "Mode UPDATEONCLOSE"

Lequel choisir

Le mode DEFAULT donne une information plus réactive, mais elle change tant que la bougie supérieure n’est pas clôturée. Sur l’historique, la valeur affichée pour une bougie de 5 minutes correspond à l’état final de la bougie horaire ; en temps réel, elle évolue pendant toute l’heure. Un signal peut donc apparaître sur l’historique alors qu’en direct il n’était pas encore présent au même moment. Le mode UPDATEONCLOSE est plus lent, mais ses valeurs ne changent plus une fois calculées. Pour un filtre de tendance utilisé dans un système de trading, c’est le choix le plus prudent.

Les règles à respecter

La documentation de ProBuilder fixe plusieurs règles :

  1. Seules des unités supérieures à celle du graphique sont autorisées, et elles doivent en être des multiples. Sur un graphique en 10 minutes, on peut utiliser 20 minutes, 1 heure ou 1 jour, mais pas 5 minutes ni 17 minutes.
  2. Une variable calculée dans une unité de temps ne peut pas être réaffectée dans une autre. En revanche, elle peut être lue partout dans le code. Si tendance est calculée sous TIMEFRAME(daily), vous pouvez la tester après TIMEFRAME(DEFAULT), mais pas lui donner une nouvelle valeur.
  3. Les systèmes de trading (backtest et trading automatique) sont limités à dix instructions TIMEFRAME intraday.
  4. ProScreener n’accepte que le mode DEFAULT et une liste prédéfinie d’unités de temps ; le sujet est traité dans le guide Screener multi-timeframe.

Exemple complet : filtre de tendance journalier sur un graphique intraday

Cet indicateur, conçu pour un graphique horaire ou plus court, calcule une moyenne de 20 jours sur des bougies journalières clôturées, puis colore une moyenne rapide de l’unité du graphique selon la tendance journalière.

// Tendance journalière (bougies clôturées) appliquée à un graphique intraday
TIMEFRAME(daily, UPDATEONCLOSE)
mmJour = Average[20](Close)              // moyenne 20 jours sur bougies journalières terminées
clotureJour = Close                      // dernière clôture journalière terminée
IF clotureJour > mmJour THEN
   tendanceJour = 1                      // tendance de fond haussière
ELSE
   tendanceJour = -1                     // tendance de fond baissière
ENDIF

TIMEFRAME(DEFAULT)                       // retour à l'unité du graphique
mmRapide = Average[20](Close)            // moyenne de l'unité du graphique

IF tendanceJour = 1 THEN                 // lecture d'une variable calculée en journalier : autorisée
   r = 0
   v = 160
ELSE
   r = 200
   v = 0
ENDIF

RETURN mmRapide COLOURED(r, v, 0) STYLE(LINE, 2) AS "MM20 filtrée par le journalier"

Toutes les variables calculées en journalier (mmJour, clotureJour, tendanceJour) sont affectées uniquement dans le bloc journalier ; les variables de couleur r et v sont affectées uniquement dans l’unité du graphique. C’est ce découpage qui respecte la règle 2. Les options d’affichage de la dernière ligne sont présentées dans le guide RETURN et affichage des courbes.

Organiser un code multi-unités de temps

Un code qui mélange plusieurs unités de temps devient vite difficile à relire. Une organisation simple évite la plupart des erreurs : regroupez en tête du programme un bloc par unité supérieure, de la plus longue à la plus courte, chacun commençant par son TIMEFRAME ; terminez par TIMEFRAME(DEFAULT) et placez ensuite toute la logique de l’unité du graphique, les conditions finales et le RETURN. Préfixez les variables selon leur unité (jourMM, h4MM, mm) : vous verrez immédiatement si une variable est affectée hors de son bloc. Enfin, limitez le nombre d’unités : deux niveaux, voire trois, suffisent presque toujours. Chaque unité supplémentaire ajoute des paramètres, ralentit le calcul et augmente le risque de sur-ajuster une stratégie à l’historique.

Pièges fréquents

  • Unité non multiple : un TIMEFRAME incompatible avec l’unité du graphique empêche le calcul. Si votre indicateur doit fonctionner sur plusieurs graphiques, choisissez une unité supérieure qui soit un multiple de toutes les unités visées.
  • Variable réaffectée dans une autre unité : déclarez des variables distinctes pour chaque unité de temps.
  • Oubli de TIMEFRAME(DEFAULT) : sans retour à l’unité du graphique, tout le reste du code est calculé dans l’unité supérieure.
  • Biais d’anticipation en mode DEFAULT : un backtest qui utilise des valeurs d’une bougie supérieure non clôturée peut paraître meilleur qu’il ne le sera en réel. Privilégiez UPDATEONCLOSE pour les filtres et vérifiez le comportement en temps réel, comme expliqué dans le guide Écarts entre ProOrder et ProBacktest.
  • Historique insuffisant : une moyenne de 200 jours exige 200 bougies journalières ; sur un graphique intraday court, elles peuvent manquer. Utilisez un test sur BarIndex, présenté dans ONCE et BarIndex, ou chargez davantage d’historique.
Un filtre multi-unités de temps réduit le nombre de signaux mais ne garantit pas leur qualité. Validez toujours une stratégie par un backtest avec coûts réalistes puis en démo avant tout passage en réel.

FAQ

Peut-on utiliser une unité de temps inférieure à celle du graphique ?

Non. TIMEFRAME n’accepte que des unités supérieures à celle du graphique, et qui en sont des multiples. Pour exploiter une unité plus fine, il faut appliquer le code à un graphique de cette unité plus fine et remonter vers les unités supérieures.

Quelle est la différence entre DEFAULT et UPDATEONCLOSE ?

En mode DEFAULT, la valeur de l’unité supérieure est recalculée à chaque nouveau prix et tient compte de la bougie supérieure en formation. En mode UPDATEONCLOSE, elle n’est recalculée qu’à la clôture de cette bougie : plus lente, mais stable.

Comment revenir à l’unité de temps du graphique ?

Écrivez TIMEFRAME(DEFAULT). Toutes les lignes suivantes sont alors calculées dans l’unité du graphique.

Pourquoi ne puis-je pas modifier une variable dans un autre TIMEFRAME ?

C’est une règle du langage : une variable calculée dans une unité de temps ne peut pas être réaffectée dans une autre, mais elle peut y être lue. Utilisez des variables distinctes pour chaque unité.

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.