ProRealTime · Instructions
Time et OpenTime en ProBuilder : heures de barre et filtres horaires
OpenTime donne l’heure d’ouverture d’une barre, Time son heure de clôture, au format HHMMSS. Fuseau, instructions horaires apparentées et fenêtres de trading sans ambiguïté.
En ProBuilder, OpenTime renvoie l’heure d’ouverture de la barre courante et Time son heure de clôture, toutes deux sous la forme d’un entier HHMMSS : 093000 pour 9 h 30. Sur une barre horaire qui couvre 10 h à 11 h, OpenTime vaut 100000 et Time vaut 110000. Cette différence d’une barre est à l’origine de la plupart des erreurs dans les filtres horaires : un système qui doit « entrer à partir de 9 h » n’aura pas le même comportement selon la variable testée. Cette page présente les deux instructions, leurs cousines (Hour, Minute, CurrentTime, DayOfWeek, Date) et la manière d’écrire des fenêtres horaires sans ambiguïté.
Elle fait partie de la rubrique Les instructions ProBuilder essentielles. Pour structurer la journée en nombre de barres plutôt qu’en heures, voyez la page IntradayBarIndex.
Définition : ouverture, clôture et heure courante
Trois instructions donnent une heure au format HHMMSS :
- OpenTime : l’heure à laquelle la barre courante a ouvert. La documentation précise le format HHMMSS et le rattache au fuseau horaire configuré dans la plateforme ;
- Time : l’heure associée à la barre, que les explications de ProRealCode identifient comme son heure de clôture.
Time[N]lit celle d’une barre passée ; - CurrentTime : l’heure actuelle, au format HHMMSS, indépendante des barres.
Un exemple publié par ProRealCode l’illustre sur des barres d’une heure : pour la barre de 10 h, OpenTime renvoie 100000 et Time renvoie 110000. Sur un graphique 15 minutes, la barre qui commence à 9 h 00 a un OpenTime de 090000 et un Time de 091500.
Ces valeurs sont des nombres, pas des heures au sens d’un type date : 093000 est simplement l’entier 93000. Les comparaisons (OpenTime >= 093000) fonctionnent parce que l’ordre des entiers HHMMSS suit l’ordre chronologique dans la journée. En revanche, l’arithmétique directe n’a pas de sens : 093000 + 4000 ne donne pas 9 h 70. La documentation de Time suggère de diviser par 10 000 pour obtenir les heures en partie entière et les minutes en partie décimale : 131500 / 10000 = 13,15, à lire 13 h 15.
Les instructions horaires apparentées
OpenTime // heure d'ouverture de la barre, HHMMSS
Time[N] // heure de clôture de la barre N barres en arrière, HHMMSS
CurrentTime // heure actuelle, HHMMSS
Hour[N] // heure (0 à 23) de la barre N barres en arrière
Minute // minute de la barre
OpenHour // heure d'ouverture de la barre (0 à 23)
DayOfWeek[N] // jour de la semaine de la barre
OpenDayOfWeek // jour de la semaine de l'ouverture de la barre
Date[N] // date de la barre, format YYYYMMDD
Pour les jours de la semaine, la documentation de DayOfWeek et d’OpenDayOfWeek indique 1 pour lundi et 7 pour dimanche. Comme pour l’heure, Hour et Minute se rapportent à la barre, tandis qu’OpenHour se rapporte explicitement à son ouverture. Avant d’utiliser l’une de ces variables dans un système, retournez-la dans un indicateur et lisez sa valeur sur quelques barres : c’est la seule façon de lever tout doute sur l’heure exacte qu’elle représente pour votre unité de temps.
Le fuseau horaire
La documentation d’OpenTime indique que l’heure renvoyée dépend du fuseau configuré dans la plateforme ; celle de CurrentTime rappelle que l’heure du serveur doit correspondre au fuseau attendu par votre stratégie. Concrètement, un filtre « 090000 » désigne 9 h dans le fuseau de votre plateforme, qui n’est pas forcément celui de la place de cotation. Un système conçu pour l’ouverture de Francfort et utilisé avec une plateforme réglée sur un autre fuseau entrera au mauvais moment. Vérifiez votre réglage et contrôlez sur un graphique que l’heure de la première barre de la séance correspond à l’ouverture du marché visé, en tenant compte des changements d’heure d’été et d’hiver, qui ne tombent pas aux mêmes dates partout.
Exemple d’indicateur : visualiser une fenêtre horaire
// Fenêtre de trading 9h00-11h30, testée sur l'heure d'ouverture des barres
startT = 090000
endT = 113000
inWindow = OpenTime >= startT AND OpenTime < endT
// Contrôle : afficher OpenTime et Time de chaque barre
RETURN inWindow AS "Dans la fenêtre", OpenTime AS "OpenTime", Time AS "Time"
Affichez cet indicateur sur un graphique 15 minutes et passez le curseur sur les barres : vous verrez que la première barre retenue est celle qui ouvre à 9 h 00 (et clôture à 9 h 15), et la dernière celle qui ouvre à 11 h 15. Si vous aviez testé Time >= 090000, la barre de 8 h 45 à 9 h 00 aurait été incluse, puisque son heure de clôture vaut 090000. C’est exactement l’écart d’une barre à garder en tête.
Exemple d’usage dans un système ProBacktest
Le système suivant combine une fenêtre d’entrée, une exclusion du vendredi et une sortie forcée en fin de séance. La logique d’entrée, une simple cassure, n’est là que pour illustrer les filtres horaires.
// Système pédagogique : filtres horaires d'un système intraday
DEFPARAM CumulateOrders = false
// Fenêtre d'entrée sur l'heure d'ouverture des barres
entryWindow = OpenTime >= 091500 AND OpenTime < 113000
// Pas de nouvelle entrée le vendredi (5 = vendredi, 1 = lundi)
notFriday = OpenDayOfWeek <> 5
breakUp = close > Highest[8](high)[1]
IF NOT LongOnMarket AND entryWindow AND notFriday AND breakUp THEN
BUY 1 CONTRACTS AT MARKET
ENDIF
// Sortie forcée : la barre qui clôture à 17h15 ou plus tard déclenche la sortie
IF LongOnMarket AND Time >= 171500 THEN
SELL AT MARKET
ENDIF
SET STOP PLOSS 40
SET TARGET PPROFIT 80
Remarquez que la sortie teste Time, l’heure de clôture : le code est évalué à la clôture de la barre de 17 h 00-17 h 15, et l’ordre au marché part à l’ouverture suivante, 17 h 15. Raisonner sur l’heure de clôture pour décider et sur l’heure d’ouverture de la barre suivante pour l’exécution est la façon la plus sûre de savoir quand vos ordres partent réellement. Les paramètres DEFPARAM FlatBefore et FlatAfter offrent une alternative pour encadrer les horaires d’un système ; ils sont présentés dans la page DEFPARAM.
Bonnes pratiques pour les filtres horaires
- Choisissez une convention et tenez-vous-y. Par exemple : OpenTime pour les fenêtres d’entrée, Time pour les sorties de fin de journée.
- Utilisez des bornes inclusives à gauche et exclusives à droite (
>= début AND < fin) : deux fenêtres consécutives ne se chevauchent jamais. - Écrivez les heures sur six chiffres dans le code, 091500 plutôt que 91500 : la valeur est identique, mais la lecture est immédiate.
- Évitez l’égalité stricte (
OpenTime = 093000) si une barre peut manquer : préférez une fenêtre ou une détection de franchissement de l’heure. - Testez les changements d’heure. Les semaines où l’Europe et les États-Unis ne sont pas encore alignés décalent les ouvertures relatives des places.
Pour une stratégie qui exploite précisément les horaires, consultez la page Système intraday sur indices.
Calculer une durée à partir des heures
Lorsque vous avez besoin d’une durée, par exemple le nombre de minutes écoulées depuis l’ouverture de la séance, convertissez d’abord l’heure en minutes depuis minuit. Avec Hour et Minute, la conversion s’écrit Hour * 60 + Minute ; la différence entre deux valeurs ainsi converties donne une durée exacte, y compris lorsque l’intervalle franchit un changement d’heure pleine. Cette méthode évite les résultats absurdes que produit une soustraction directe de deux entiers HHMMSS, comme 100500 − 095500 = 5000 au lieu de dix minutes. Elle permet aussi d’écrire des règles du type « pas d’entrée plus de 90 minutes après l’ouverture », qui restent lisibles et faciles à modifier.
Pièges fréquents
- Confondre Time et OpenTime. Sur une même barre, l’écart vaut une unité de temps du graphique ; un filtre peut inclure ou exclure une barre de trop.
- Faire des calculs directs sur HHMMSS. Ajouter des minutes à un entier HHMMSS donne des valeurs invalides ; convertissez en minutes depuis minuit si vous devez calculer des durées.
- Ignorer le fuseau horaire de la plateforme. Les heures de votre code sont celles de votre réglage, pas forcément celles de la place de cotation.
- Utiliser CurrentTime en backtest. CurrentTime renvoie l’heure actuelle, pas celle des barres historiques ; pour un filtre reproductible en backtest, utilisez les heures de barre.
- Supposer que les jours vont de 0 à 6. La documentation de DayOfWeek indique 1 pour lundi et 7 pour dimanche ; vérifiez sur un graphique avant d’exclure un jour.
FAQ
Quelle différence entre Time et OpenTime ?
OpenTime est l’heure d’ouverture de la barre, Time son heure de clôture. Sur une barre de 15 minutes qui commence à 9 h 00, OpenTime vaut 090000 et Time 091500.
Dans quel format sont renvoyées les heures ?
Sous forme d’entier HHMMSS : 143000 pour 14 h 30. Les comparaisons fonctionnent directement ; pour lire heures et minutes, divisez par 10 000.
Quel fuseau horaire utilise OpenTime ?
La documentation indique le fuseau configuré dans la plateforme. Vérifiez votre réglage et la correspondance avec les horaires de la place de cotation, notamment lors des changements d’heure.
Comment exclure le vendredi d’un système ?
Testez OpenDayOfWeek <> 5, la documentation indiquant 1 pour lundi. Contrôlez la valeur sur un graphique avant de l’utiliser dans un backtest.
