STRINGFORMAT

Syntaxe

SCREENER(value AS "Column name" STRINGFORMAT)

Comment ça marche

Les tableaux de résultats du screener appliquent un formatage automatique pour rendre les nombres lisibles, ce qui peut raccourcir les grandes valeurs en formes comme 20.2M. Lorsque les chiffres exacts importent, cette transformation détruit de l'information. Placer STRINGFORMAT après le AS "Column name" supprime toute conversion automatique et affiche la valeur telle quelle.

C'est le pendant de désactivation des trois autres modificateurs d'affichage. DATEFORMAT réinterprète le nombre comme une date calendaire, NUMBERFORMAT abrège sa magnitude, et PERCENTFORMAT le multiplie par 100. STRINGFORMAT ne fait aucune de ces choses, ce qui en fait le bon choix pour les identifiants, les valeurs encodées telles que des YYYYMMDD les dates qui doivent rester numériques, ou tout chiffre qui doit survivre à l'export sans arrondi.

Malgré son nom, le modificateur ne transforme pas la valeur en texte et n'active aucune manipulation de chaîne. Les colonnes ProScreener contiennent toujours des nombres. Le mot-clé contrôle uniquement la façon dont le nombre est affiché dans le tableau de résultats.

Exemples

Exemple 1, Afficher une valeur brute sans conversion (ProScreener)

// The value appears exactly as stored, digit for digit
number = 20221202
SCREENER(number AS "Raw Value" STRINGFORMAT)

La colonne affiche 20221202 inchangé, où NUMBERFORMAT l'aurait raccourci à 20.2M. C'est l'exemple canonique de la référence officielle.

Exemple 2, Garder une date au format numérique (ProScreener)

// Show the bar date as a plain YYYYMMDD number, not a formatted date
barDate = OpenDate
aboveMA = close > Average[50](close)
SCREENER[aboveMA](barDate AS "Raw date" STRINGFORMAT)

La date d'ouverture reste dans un format exploitable par la machine YYYYMMDD forme, ce qui est pratique lorsque les résultats sont exportés et traités par d'autres outils.

Exemple 3, Chiffres de volume exacts (ProScreener)

// List active instruments with their full, unabbreviated volume
active = Volume > 1000000
SCREENER[active](Volume AS "Exact volume" STRINGFORMAT)

Chaque résultat affiche le chiffre de volume complet, par exemple 1483920 plutôt que la valeur arrondie 1.5M une colonne abrégée afficherait.

Erreurs et pièges courants

• Ce n'est pas un type chaîne. Le mot-clé ne crée pas de valeurs texte, ne concatène pas de libellés et ne formate pas de chaînes arbitraires. ProScreener n'a pas de variables de type chaîne. STRINGFORMAT signifie seulement « afficher le nombre tel quel ».
• Colonnes larges. Les grands nombres en précision complète occupent plus d'espace horizontal que les nombres abrégés. Les screeners renvoyant de nombreuses colonnes de valeurs brutes deviennent difficiles à lire, réservez donc le modificateur aux valeurs où les chiffres exacts comptent.
• Un seul modificateur de format par colonne. STRINGFORMAT ne peut pas être combiné avec DATEFORMAT, NUMBERFORMAT, ou PERCENTFORMAT sur la même colonne. Choisissez l'unique modificateur qui correspond aux données.
• ProScreener uniquement. Le mot-clé ne compile nulle part ailleurs. En dehors des screeners, l'affichage de la valeur brute est le comportement par défaut et ne nécessite aucun modificateur.

Instructions liées

• DATEFORMAT, affiche un nombre YYYYMMDD sous forme de date lisible dans une colonne de screener.
• NUMBERFORMAT, abrège les grandes valeurs numériques dans une colonne de screener.
• PERCENTFORMAT, affiche la valeur d'une colonne de screener en pourcentage.
• SCREENER, définit la condition de filtre et la colonne de résultat d'un screener.
• Volume, le volume de transactions enregistré sur un bar.
• OpenDate, la date d'ouverture d'un bar sous la forme YYYYMMDD.
• TIMEFRAME (PS), définit l'unité de temps utilisée par le code de screener qui suit.