OpenTimestamp

Syntaxe

OpenTimestamp

Le mot-clé ne prend aucun paramètre. Un indice d'historique entre crochets lit les bars antérieures, donc OpenTimestamp[1] donne l'horodatage d'ouverture du bar précédent.

Comment ça marche

Un horodatage Unix compte le temps comme un total cumulé de secondes à partir de l'Epoch Unix, 1 January 1970 à 00:00:00 UTC. OpenTimestamp indique ce décompte pour le moment où la bougie courante s'est ouverte. Comme l'échelle est ancrée sur UTC, la valeur est identique pour tous les utilisateurs quels que soient les réglages de fuseau horaire de la plateforme ou les passages à l'heure d'été.

Cela fait d'OpenTimestamp le bon outil pour les calculs de durée. Soustraire deux horodatages donne une différence en secondes entières, ce qui n'est pas fiable avec des valeurs HHMMSS telles que OpenTime, où les chiffres encodent les heures et les minutes plutôt qu'un compte linéaire.

Le mot-clé complémentaire Timestamp indique l'heure Unix de la clôture du bar. La différence Timestamp - OpenTimestamp vaut donc la durée du bar sur les bars terminés, et l'âge atteint jusqu'ici par le bar sur le bar en cours de formation. Les différences entre les horodatages d'ouverture de bars consécutifs révèlent les trous dans les données, comme les interruptions nocturnes ou les week-ends.

Exemples

Exemple 1, secondes écoulées dans le bar courant (Indicateur)

// Seconds between the bar open and the bar timestamp
elapsed = Timestamp - OpenTimestamp
RETURN elapsed

Sur les bars terminés, le tracé est égal à la durée du bar en secondes. Sur le bar en cours, il indique depuis combien de temps la bougie se forme.

Exemple 2, détection d'un gap de séance entre deux bars (ProOrder)

// Detect a gap larger than 4 hours between consecutive bar opens
gapSeconds = OpenTimestamp - OpenTimestamp[1]
IF gapSeconds > 14400 AND NOT OnMarket THEN
  // The first bar after a long break, such as a new session
  BUY 1 CONTRACT AT MARKET
ENDIF
SET STOP PLOSS 40

Comparer les horodatages d'ouverture de deux bars consécutifs mesure le temps réel écoulé entre eux, ce qui identifie le premier bar après une interruption de nuit ou de week-end.

Exemple 3, exclusion des instruments aux données périmées (ProScreener)

// Match instruments whose current bar opened within the last 15 minutes
fresh = Timestamp - OpenTimestamp < 900
SCREENER[fresh] ("Fresh bar")

Le screener conserve les instruments dont la dernière bougie a moins de 900 secondes, en écartant ceux qui n'ont pas publié de données récentes.

Erreurs et pièges courants

• Secondes, pas millisecondes. Les horodatages Unix de ProBuilder comptent des secondes. Les constantes copiées depuis d'autres environnements qui utilisent des epochs en millisecondes seront fausses d'un facteur 1000.
• Mélanger les systèmes horodatage et HHMMSS. OpenTimestamp se situe sur une échelle UTC linéaire tandis que OpenTime est un composite HHMMSS en heure locale. Comparer ou soustraire des valeurs issues des deux systèmes produit des nombres dénués de sens.
• Supposer l'heure locale. La valeur est ancrée sur UTC. Les bornes de séance définies en heures locales doivent être gérées avec OpenTime ou OpenHour, et non en ajoutant un décalage fixe à l'horodatage, car les décalages changent avec l'heure d'été.
• Clôture du bar contre horloge. Sur les bars historiques, Timestamp est l'heure de clôture de ce bar, pas l'instant présent. Timestamp - OpenTimestamp ne suit un âge courant que sur la bar en cours de formation.

Instructions liées

• Timestamp, horodatage Unix de la clôture du bar.
• OpenTime, heure d'ouverture du bar sous forme d'entier HHMMSS local.
• CurrentTime, heure courante de l'horloge au format HHMMSS.
• TIME, heure de clôture d'un bar au format HHMMSS.
• OpenDate, date à laquelle le bar s'est ouvert, au format YYYYMMDD.
• OpenHour, composante horaire de l'heure d'ouverture du bar.
• BarIndex, nombre de bars depuis le début de l'historique chargé.
• IntradayBarIndex, compteur de bars qui se remet à zéro au début de chaque jour.