STRINGFORMAT

Syntaxis

SCREENER(value AS "Column name" STRINGFORMAT)

Hoe het werkt

Resultatentabellen van de screener passen automatische opmaak toe om getallen leesbaar te maken, waardoor grote waarden kunnen worden verkort tot vormen als 20.2M. Als de exacte cijfers belangrijk zijn, vernietigt die transformatie informatie. Het plaatsen van STRINGFORMAT na de AS "Column name" clausule onderdrukt alle automatische conversie en print de waarde letterlijk.

Dit is de opt-out-tegenhanger van de andere drie weergavemodifiers. DATEFORMAT interpreteert het getal opnieuw als kalenderdatum, NUMBERFORMAT kort de magnitude ervan af, en PERCENTFORMAT schaalt het met 100. STRINGFORMAT doet dit alles niet, waardoor hij de juiste keuze is voor identifiers, gecodeerde waarden zoals ruwe YYYYMMDD datums die numeriek moeten blijven, of elk getal dat de export zonder afronding moet doorstaan.

Ondanks de naam zet de modifier de waarde niet om in tekst en maakt hij stringmanipulatie niet mogelijk. ProScreener-kolommen bevatten altijd getallen. Het keyword bepaalt alleen hoe het getal in de resultatentabel wordt weergegeven.

Voorbeelden

Voorbeeld 1, Een ruwe waarde weergeven zonder conversie (ProScreener)

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

De kolom toont 20221202 onveranderd, waarbij NUMBERFORMAT zou het hebben verkort tot 20.2M. Dit is het canonieke voorbeeld uit de officiële referentie.

Voorbeeld 2, Een datum numeriek houden (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)

De openingsdatum blijft in machinevriendelijk YYYYMMDD vorm, wat handig is wanneer resultaten worden geëxporteerd en door andere tools verwerkt.

Voorbeeld 3, Exacte volumecijfers (ProScreener)

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

Elk resultaat toont het volledige volumecijfer, bijvoorbeeld 1483920 in plaats van de afgeronde 1.5M een afgekorte kolom zou weergeven.

Veelvoorkomende fouten en valkuilen

• Geen stringtype. Het keyword maakt geen tekstwaarden aan, plakt geen labels aan elkaar en formatteert geen willekeurige strings. ProScreener heeft geen stringvariabelen. STRINGFORMAT betekent alleen "geef het getal weer zoals het is".
• Brede kolommen. Grote getallen met volledige precisie nemen meer horizontale ruimte in dan afgekorte. Screeners die veel kolommen met ruwe waarden teruggeven worden moeilijk leesbaar, dus houd de modifier voor waarden waarbij de exacte cijfers van belang zijn.
• Één format-modifier per kolom. STRINGFORMAT kan niet gecombineerd worden met DATEFORMAT, NUMBERFORMAT, of PERCENTFORMAT op dezelfde kolom. Kies de enige modifier die bij de data past.
• Alleen ProScreener. Het keyword compileert nergens anders. Buiten screeners is weergave van de ruwe waarde het standaardgedrag en is geen modifier nodig.

Gerelateerde instructies

• DATEFORMAT, geeft een YYYYMMDD-getal weer als een leesbare datum in een screenerkolom.
• NUMBERFORMAT, kort grote numerieke waarden in een screenerkolom af.
• PERCENTFORMAT, geeft een waarde in een screenerkolom weer als percentage.
• SCREENER, definieert de filtervoorwaarde en de resultaatkolom van een screener.
• Volume, het transactievolume dat op een bar is vastgelegd.
• OpenDate, de openingsdatum van een bar in YYYYMMDD-vorm.
• TIMEFRAME (PS), stelt het tijdframe in dat door de volgende screenercode wordt gebruikt.