OpenTimestamp

Sintassi

OpenTimestamp

La parola chiave non accetta parametri. Un indice storico tra parentesi quadre legge le bar precedenti, quindi OpenTimestamp[1] restituisce il timestamp di apertura del bar precedente.

Come funziona

Un timestamp Unix misura il tempo come totale progressivo di secondi a partire dall'Unix Epoch, 1 January 1970 alle 00:00:00 UTC. OpenTimestamp riporta quel conteggio per il momento in cui si è aperta la candela corrente. Poiché la scala è ancorata a UTC, il valore è identico per ogni utente indipendentemente dalle impostazioni di fuso orario della piattaforma o dai passaggi all'ora legale.

Questo rende OpenTimestamp lo strumento giusto per il calcolo di durate. Sottraendo due timestamp si ottiene una differenza in secondi interi, cosa che non è sicura con i valori HHMMSS come OpenTime, dove le cifre codificano ore e minuti anziché un conteggio lineare.

La parola chiave complementare Timestamp riporta il tempo Unix della chiusura della bar. La differenza Timestamp - OpenTimestamp equivale quindi alla durata del bar sui bar completati e all'età raggiunta finora dal bar in formazione live. Le differenze tra i timestamp di apertura di bar consecutivi mettono in evidenza i gap nei dati, come le interruzioni notturne o i fine settimana.

Esempi

Esempio 1, secondi trascorsi all'interno della bar corrente (Indicatore)

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

Sulle bar completate il tracciato è pari alla durata della bar in secondi. Sulla bar in corso mostra da quanto tempo la candela si sta formando.

Esempio 2, rilevare un gap di sessione tra le bar (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

Confrontare i timestamp di apertura di due bar consecutive misura il tempo reale trascorso tra di esse, il che identifica la prima bar dopo un'interruzione notturna o di fine settimana.

Esempio 3, escludere gli strumenti obsoleti (ProScreener)

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

Lo screener mantiene gli strumenti la cui ultima candela è più recente di 900 secondi, scartando quelli che non hanno stampato dati recenti.

Errori e insidie comuni

• Secondi, non millisecondi. I timestamp Unix di ProBuilder contano i secondi. Le costanti copiate da altri ambienti che usano epoch in millisecondi saranno errate di un fattore 1000.
• Mescolare i sistemi timestamp e HHMMSS. OpenTimestamp si trova su una scala UTC lineare mentre OpenTime è un valore composito HHMMSS in ora locale. Confrontare o sottrarre valori tra i due sistemi produce numeri privi di senso.
• Dare per scontata l'ora locale. Il valore è ancorato a UTC. I limiti di sessione definiti in ore locali devono essere gestiti con OpenTime o OpenHour, non aggiungendo uno scostamento fisso al timestamp, poiché gli scostamenti cambiano con l'ora legale.
• Chiusura della bar rispetto all'orologio. Sulle bar storiche, Timestamp è l'orario di chiusura di quella bar, non il momento attuale. Timestamp - OpenTimestamp tiene traccia dell'età corrente solo sul bar in formazione.

Istruzioni correlate

• Timestamp, timestamp Unix della chiusura della bar.
• OpenTime, ora di apertura della bar come intero HHMMSS locale.
• CurrentTime, ora attuale dell'orologio in formato HHMMSS.
• TIME, orario di chiusura di una bar in formato HHMMSS.
• OpenDate, data in cui la bar si è aperta, in formato YYYYMMDD.
• OpenHour, componente dell'ora dell'orario di apertura della bar.
• BarIndex, numero di bar dall'inizio dello storico caricato.
• IntradayBarIndex, contatore di bar che si azzera all'inizio di ogni giorno.