DATEFORMAT

Sintassi

SCREENER(value AS "Column name" DATEFORMAT)

Come funziona

A SCREENER la colonna dei risultati mostra normalmente il valore numerico grezzo dell'espressione che le è stata passata. Quando l'espressione codifica una data, quel numero grezzo è difficile da leggere. Inserire DATEFORMAT dopo il AS "Column name" clausola indica alla tabella dei risultati di interpretare il numero come una data in YYYYMMDD forma e renderizzarlo in un formato leggibile.

Il modificatore cambia solo la presentazione. Il valore sottostante resta numerico, quindi l'ordinamento della colonna continua a operare sul numero stesso. Poiché YYYYMMDD i valori si ordinano nello stesso ordine delle date che rappresentano, l'ordinamento cronologico si comporta come previsto.

DATEFORMAT si abbina naturalmente alle costanti di data e ora del linguaggio. Valori come Today, Yesterday, e OpenDate restituiscono già numeri in YYYYMMDD forma, così possono essere passati direttamente in una colonna formattata. Qualsiasi altra espressione numerica è accettata, ma solo i valori che codificano una data di calendario valida producono un output significativo.

Esempi

Esempio 1, Visualizzare una data numerica fissa (ProScreener)

// A numeric value in YYYYMMDD form, here 2 December 2022
number = 20221202
SCREENER(number AS "Formatted Date" DATEFORMAT)

La colonna etichettata Formatted Date mostra 2 Dec 2022 invece del numero grezzo 20221202. Questo è l'esempio canonico del riferimento ufficiale.

Esempio 2, Mostrare la data della bar per i titoli ipervenduti (ProScreener)

// List oversold instruments together with the date of the scanned bar
myRSI = RSI[14](close)
oversold = myRSI < 30
barDate = OpenDate
SCREENER[oversold](barDate AS "Bar date" DATEFORMAT)

Ogni strumento corrispondente appare con la data di apertura della sua bar più recente resa come data leggibile, il che è utile quando si analizzano mercati la cui ultima sessione può differire.

Esempio 3, Associare la data della scansione ai nuovi massimi (ProScreener)

// Stamp each result with the date the scan was run
newHigh = close >= Highest[250](close)
SCREENER[newHigh](Today AS "Scan date" DATEFORMAT)

Gli strumenti che segnano un massimo di chiusura a 250 bar sono elencati con la data corrente come colonna formattata, il che aiuta nell'esportazione o nell'archiviazione dei risultati dello screener.

Errori e insidie comuni

• Il valore deve codificare YYYYMMDD. DATEFORMAT non converte timestamp, conteggi di giorni o numeri arbitrari in date. Un valore come 1670000000 (un timestamp in stile Unix) o 45123 produce una data senza senso. Costruisci il valore come anno per 10000 più mese per 100 più giorno, oppure usa costanti come Today che restituiscono già quella forma.
• Nessuna convalida della data. Il modificatore formatta qualsiasi cifra riceva. Un valore come 20221399 (mese 13, giorno 99) non viene rifiutato in fase di compilazione e produce un output privo di senso. Verifica l'espressione che alimenta la colonna.
• Un solo modificatore di formato per colonna. DATEFORMAT non può essere combinato con NUMBERFORMAT, PERCENTFORMAT, o STRINGFORMAT sulla stessa colonna. Scegli l'unico modificatore che corrisponde ai dati.
• Solo ProScreener. La parola chiave non compila in nessun altro contesto. In un indicatore la visualizzazione della data è gestita diversamente, in genere con DRAWTEXT output di stile, non con DATEFORMAT.

Istruzioni correlate

• NUMBERFORMAT, abbrevia i valori numerici grandi in una colonna dello screener.
• PERCENTFORMAT, mostra il valore di una colonna dello screener come percentuale.
• STRINGFORMAT, mostra il valore di una colonna dello screener esattamente come memorizzato.
• SCREENER, definisce la condizione di filtro e la colonna dei risultati di uno screener.
• TIMEFRAME (PS), imposta il timeframe usato dal codice screener successivo.
• Today, la data corrente nel formato YYYYMMDD.
• Yesterday, la data di calendario precedente nel formato YYYYMMDD.
• OpenDate, la data di apertura di una bar in forma YYYYMMDD.