NUMBERFORMAT
NUMBERFORMAT is een weergavemodifier in ProScreener die grote numerieke waarden in SCREENER-resultaatkolommen afkort, bijvoorbeeld 20221202 weergeven als 20.2M.
Syntaxis
SCREENER(value AS "Column name" NUMBERFORMAT)Hoe het werkt
Screenerkolommen met volume, omzet of andere grote getallen worden snel moeilijk te vergelijken wanneer elke cel acht of negen cijfers lang is. Het plaatsen van NUMBERFORMAT na de AS "Column name" clausule vertelt de resultatentabel de waarde te verkorten met standaard grootteachtervoegsels, zodat miljoenen worden weergegeven met een M suffix en duizenden met een K suffix, met ongeveer drie significante cijfers.
De modifier beïnvloedt alleen de presentatie. De waarde met volledige precisie blijft achter de kolom aanwezig, dus het sorteren van de resultaten gebeurt nog steeds op het exacte getal en niet op de afgeronde weergavetekst.
NUMBERFORMAT is een van de vier weergavemodifiers die op een kolomdefinitie kunnen volgen, naast DATEFORMAT, PERCENTFORMAT, en STRINGFORMAT. Er kan precies één modifier per kolom worden toegepast, en de keuze gaat puur over hoe het getal moet worden gelezen in de resultatentabel.
Voorbeelden
Voorbeeld 1, Een groot vast getal afkorten (ProScreener)
// A large numeric value, displayed in shortened form
number = 20221202
SCREENER(number AS "Formatted Number" NUMBERFORMAT)De kolom toont 20.2M in plaats van de ruwe 20221202. Dit is het canonieke voorbeeld uit de officiële referentie.
Voorbeeld 2, Leesbare kolom met gemiddeld volume (ProScreener)
// Liquidity filter with an abbreviated average volume column
avgVol = Average[20](Volume)
liquid = avgVol > 500000
SCREENER[liquid](avgVol AS "Avg volume" NUMBERFORMAT)Instrumenten die over 20 bars gemiddeld meer dan 500,000 eenheden verhandelen worden vermeld met hun gemiddelde volume weergegeven als een compact getal zoals 1.2M.
Voorbeeld 3, Benaderde omzet in valuta-eenheden (ProScreener)
// Traded value approximated as price times volume
turnover = close * Volume
SCREENER[turnover > 10000000](turnover AS "Turnover" NUMBERFORMAT)Prijs maal volume geeft een grove waarde van het verhandelde bedrag. De afkorting houdt een kolom met getallen van negen cijfers in één oogopslag leesbaar.
Veelvoorkomende fouten en valkuilen
- Precisie gaat verloren in de weergave. De afkorting rondt af op ongeveer drie significante cijfers, dus
20221202en20240101beide tonen als20.2M. Wanneer exacte waarden van belang zijn, gebruikSTRINGFORMATin plaats daarvan, of laat de modifier weg. - Één format-modifier per kolom.
NUMBERFORMATkan niet gecombineerd worden metDATEFORMAT,PERCENTFORMAT, ofSTRINGFORMATop dezelfde kolom. Kies de enige modifier die bij de data past. - Geen omzetter voor percentages of datums. De modifier verkort alleen de grootte. Een ratio zoals
0.05blijft0.05, het wordt niet5%, en een datumnummer wordt20.2Min plaats van een kalenderdatum. GebruikPERCENTFORMATofDATEFORMATvoor die gevallen. - Alleen ProScreener. Het sleutelwoord compileert nergens anders. Indicatoren regelen de weergave van getallen via hun eigen instellingen, niet via screener-modifiers.
Gerelateerde instructies
DATEFORMAT, geeft een YYYYMMDD-getal weer als een leesbare datum in een screenerkolom.PERCENTFORMAT, geeft een waarde in een screenerkolom weer als percentage.STRINGFORMAT, toont een waarde in een screenerkolom precies zoals opgeslagen.SCREENER, definieert de filtervoorwaarde en de resultaatkolom van een screener.EstimatedVolume, het verwachte eindvolume van de huidige bar in ProScreener.Volume, het transactievolume dat op een bar is vastgelegd.TIMEFRAME (PS), stelt het tijdframe in dat door de volgende screenercode wordt gebruikt.