English
Rejoignez-nous
ProScreener/proscreener

NUMBERFORMAT

NUMBERFORMAT est un modificateur d'affichage ProScreener qui abrège les grandes valeurs numériques dans les colonnes de résultats SCREENER, affichant par exemple 20221202 sous la forme 20.2M.

Syntaxe

probuilder
SCREENER(value AS "Column name" NUMBERFORMAT)

Comment ça marche

Les colonnes de screener qui portent le volume, la valeur échangée ou d'autres grands nombres deviennent vite difficiles à comparer quand chaque cellule compte huit ou neuf chiffres. Placer NUMBERFORMAT après le AS "Column name" clause indique au tableau de résultats d'abréger la valeur à l'aide des suffixes de grandeur standard, de sorte que les millions s'affichent avec un M suffixe et les milliers avec un K suffixe, en conservant environ trois chiffres significatifs.

Le modificateur n'affecte que la présentation. La valeur en précision complète reste derrière la colonne, de sorte que le tri des résultats s'effectue toujours sur le nombre exact plutôt que sur le texte arrondi affiché.

NUMBERFORMAT est l'un des quatre modificateurs d'affichage qui peuvent suivre une définition de colonne, aux côtés de DATEFORMAT, PERCENTFORMAT, et STRINGFORMAT. Exactement un modificateur peut être appliqué par colonne, et le choix porte uniquement sur la façon dont le nombre doit se lire dans le tableau de résultats.

Exemples

Exemple 1, Abréger un grand nombre fixe (ProScreener)

probuilder
// A large numeric value, displayed in shortened form
number = 20221202
SCREENER(number AS "Formatted Number" NUMBERFORMAT)

La colonne affiche 20.2M au lieu du brut 20221202. C'est l'exemple canonique de la référence officielle.

Exemple 2, Colonne de volume moyen lisible (ProScreener)

probuilder
// Liquidity filter with an abbreviated average volume column
avgVol = Average[20](Volume)
liquid = avgVol > 500000
SCREENER[liquid](avgVol AS "Avg volume" NUMBERFORMAT)

Les instruments qui échangent plus de 500,000 unités en moyenne sur 20 bars sont listés avec leur volume moyen affiché sous forme compacte, par exemple 1.2M.

Exemple 3, Volume d'affaires approximatif en unités monétaires (ProScreener)

probuilder
// Traded value approximated as price times volume
turnover = close * Volume
SCREENER[turnover > 10000000](turnover AS "Turnover" NUMBERFORMAT)

Multiplier le prix par le volume donne une valeur échangée approximative. L'abréviation garde une colonne de nombres à neuf chiffres lisible d'un coup d'œil.

Erreurs et pièges courants

  • De la précision est perdue à l'affichage. L'abréviation arrondit à environ trois chiffres significatifs, donc 20221202 et 20240101 s'affichent tous deux comme 20.2M. Quand les valeurs exactes comptent, utilisez STRINGFORMAT à la place, ou omettez le modificateur.
  • Un seul modificateur de format par colonne. NUMBERFORMAT ne peut pas être combiné avec DATEFORMAT, PERCENTFORMAT, ou STRINGFORMAT sur la même colonne. Choisissez l'unique modificateur qui correspond aux données.
  • Ce n'est pas un convertisseur de pourcentage ou de date. Le modificateur ne réduit que l'amplitude. Un ratio comme 0.05 reste 0.05, il ne devient pas 5%, et un numéro de date devient 20.2M plutôt qu'une date de calendrier. Utilisez PERCENTFORMAT ou DATEFORMAT pour ces cas.
  • ProScreener uniquement. Le mot-clé ne compile nulle part ailleurs. Les indicateurs contrôlent l'affichage des nombres par leurs propres réglages, et non par des modificateurs de screener.
  • DATEFORMAT, affiche un nombre YYYYMMDD sous forme de date lisible dans une colonne de screener.
  • PERCENTFORMAT, affiche la valeur d'une colonne de screener en pourcentage.
  • 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.
  • EstimatedVolume, volume final projeté du bar courant dans ProScreener.
  • Volume, le volume de transactions enregistré sur un bar.
  • TIMEFRAME (PS), définit l'unité de temps utilisée par le code de screener qui suit.