TIME

Syntaxe

Time
Time[N]

Paramètres

Comment ça marche

TIME encode l'heure de chaque bar sous forme d'entier compact au format HHMMSS. Un bar formé à 13:15:00 donne 131500 : les deux premiers chiffres sont l'heure au format 24 heures, les deux suivants les minutes et les deux derniers les secondes. La valeur correspond au côté clôture du bar ; le moment d'ouverture est exposé séparément via OpenTime.

La valeur suit le fuseau horaire local configuré dans la plateforme ProRealTime™, de sorte qu'un code identique peut correspondre à des bars différents selon les réglages des utilisateurs.

Comme le format est positionnel et non linéaire, sa conversion pour l'affichage exige de découper les chiffres. Diviser par 10000 place l'heure devant la virgule décimale, donc 131500 / 10000 donne 13.15, lisible comme 13:15. Ce n'est qu'une astuce de présentation : la partie décimale contient les minutes, pas une fraction d'heure, le résultat ne convient donc pas aux calculs de durée. Les calculs de temps écoulé relèvent de Timestamp et OpenTimestamp, qui comptent des secondes linéaires.

L'index entre crochets donne accès à l'historique. Time[1] lit l'heure du bar précédent, ce qui permet des contrôles comme détecter le premier bar d'une séance en comparant des valeurs consécutives.

Exemples

Exemple 1, Convertir l'heure du bar en un nombre lisible (Indicateur)

// Convert the current bar time into an HH.MM style number
myTime = Time[0] / 10000
RETURN myTime

Si l'heure de la bar courante est 131500, le tracé affiche 13.15, qui se lit 13:15. La conversion sert uniquement à l'affichage.

Exemple 2, Se mettre à plat avant la fin de la séance (ProOrder)

// Close any open position at or after 21:45
IF Time >= 214500 THEN
  SELL AT MARKET
  EXITSHORT AT MARKET
ENDIF

La stratégie sort des positions long et short dès que l'heure du bar atteint 21:45, une pratique courante pour les systèmes intraday qui ne doivent pas conserver de position overnight.

Exemple 3, Screener les breakouts du matin (ProScreener)

// Match instruments breaking their 20-bar high during the morning
breakout = high >= Highest[20](high)
morning = Time >= 90000 AND Time <= 120000
SCREENER[breakout AND morning] ("Morning breakout")

Le screener combine une condition de prix avec une fenêtre TIME afin que seuls les signaux produits entre 09:00 et 12:00 soient listés.

Erreurs et pièges courants

• Traiter HHMMSS comme linéaire. 120000 - 115900 égale 4100, et non une minute. La soustraction au-delà des frontières d'heure ou de minute n'a aucun sens dans ce format ; utilisez Timestamp pour les durées.
• L'égalité exacte manque des bars. Time = 100000 ne correspond que lorsqu'un bar clôture exactement à 10:00:00. Sur les unités de temps qui ne s'alignent pas sur cet instant, la condition ne se déclenche jamais. Les comparaisons par intervalle sont plus fiables.
• Dépendance au fuseau horaire. Les valeurs suivent le réglage de fuseau horaire local de la plateforme. Le même script peut se comporter différemment sur un VPS ou sur la machine d'un autre utilisateur si les réglages ne correspondent pas.
• Confusion entre ouverture et clôture. TIME décrit le moment où une bar se termine, OpenTime au moment où il commence. Sur des bars horaires, les deux diffèrent d'une heure entière, assez pour décaler les filtres de séance d'un bar.

Instructions liées

• CurrentTime, heure de l'horloge plutôt que l'heure d'un bar.
• OpenTime, heure d'ouverture d'un bar au format HHMMSS.
• OpenTimestamp, timestamp Unix de l'ouverture du bar pour le calcul de durées.
• Timestamp, horodatage Unix de la clôture du bar en secondes.
• Hour, composante heure de l'heure du bar.
• Minute, composante minute de l'heure du bar.
• Second, composante secondes de l'heure du bar.
• Today, date du bar courant au format YYYYMMDD.