PERCENTFORMAT

Syntaxe

SCREENER(value AS "Column name" PERCENTFORMAT)

Comment ça marche

Les ratios et les mesures de performance sont généralement calculés sous forme de fractions décimales, où 0.05 signifie cinq pour cent. Placer PERCENTFORMAT après le AS "Column name" clause indique au tableau des résultats de multiplier la valeur par 100, d'arrondir à deux décimales et d'ajouter un signe pourcent, afin que la fraction se lise naturellement dans les résultats.

La mise à l'échelle est fixe. Quel que soit le nombre qui arrive dans la colonne, il est multiplié par 100, c'est pourquoi l'exemple de la référence, qui fournit la valeur brute 20221202, s'affiche comme 2,022,120,200.00%. Le modificateur ne détecte pas si une valeur est déjà exprimée en pourcentage, l'expression qui alimente la colonne doit donc être une simple fraction.

Comme les autres modificateurs d'affichage, PERCENTFORMAT ne modifie que la présentation. Le tri et le filtrage portent toujours sur la valeur numérique sous-jacente, et un seul des DATEFORMAT, NUMBERFORMAT, PERCENTFORMAT, ou STRINGFORMAT peut s'appliquer par colonne.

Exemples

Exemple 1, valeur fixe illustrant le comportement de mise à l'échelle (ProScreener)

// Any numeric value is multiplied by 100 and shown with a percent sign
number = 20221202
SCREENER(number AS "Formatted Percentage" PERCENTFORMAT)

La colonne affiche 2,022,120,200.00%, ce qui montre que le modificateur multiplie toujours par 100. C'est l'exemple canonique de la documentation officielle.

Exemple 2, performance sur 20 bars en pourcentage (ProScreener)

// Performance over 20 bars, computed as a decimal fraction
perf = close / close[20] - 1
SCREENER[perf > 0.05](perf AS "Perf 20 bars" PERCENTFORMAT)

Les instruments en hausse de plus de cinq pour cent sur 20 bars sont listés, et la fraction 0.0523 s'affiche comme 5.23% dans la colonne des résultats.

Exemple 3, colonne de gap de nuit (ProScreener)

// Gap between today's open and the previous close, as a fraction
gap = (open - close[1]) / close[1]
SCREENER[ABS(gap) > 0.02](gap AS "Gap" PERCENTFORMAT)

Les instruments présentant un gap de plus de deux pour cent dans un sens ou dans l'autre sont retournés, avec la taille du gap affichée en pourcentage signé.

Erreurs et pièges courants

• Double mise à l'échelle. Fournir à la colonne une valeur déjà exprimée en pourcentage la multiplie encore par 100, donc 5 s'affiche comme 500.00%. Des indicateurs comme Variation et ROC renvoient déjà des pourcentages, divisez-les donc par 100 avant la colonne ou omettez le modificateur.
• Arrondi fixe à deux décimales. L'affichage arrondit à deux décimales. Les petites fractions comme 0.0001 s'affiche comme 0.01%, et les distinctions plus fines sont invisibles dans la colonne même si le tri utilise toujours la valeur exacte.
• Un seul modificateur de format par colonne. PERCENTFORMAT ne peut pas être combiné avec DATEFORMAT, NUMBERFORMAT, ou STRINGFORMAT sur la même colonne. Choisissez l'unique modificateur qui correspond aux données.
• ProScreener uniquement. Le mot-clé ne compile nulle part ailleurs. L'affichage en pourcentage dans les indicateurs s'obtient en mettant à l'échelle la valeur retournée, et non avec des modificateurs de screener.

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.
• STRINGFORMAT, affiche la valeur d'une colonne de screener exactement telle qu'elle est stockée.
• SCREENER, définit la condition de filtre et la colonne de résultat d'un screener.
• Variation, variation en pourcentage du bar courant, déjà multipliée par 100.
• ROC, indicateur de taux de variation, déjà exprimé en pourcentage.
• TIMEFRAME (PS), définit l'unité de temps utilisée par le code de screener qui suit.