Scriban-templates

Tarasa gebruikt de template-engine Scriban voor het renderen van teksttemplates, bijvoorbeeld e-mails en documenten. De gegevens van de template zijn beschikbaar via de variabele vm (bijvoorbeeld {{ vm.name }}). Naast de ingebouwde functies van Scriban zijn de onderstaande opmaakfuncties beschikbaar. Alle functies ondersteunen de pipe-syntax.

Laat je een locale- of tijdzone-parameter weg, dan worden de PrimaryLocale en PrimaryTimeZone van de applicatie gebruikt.

Opmaakfuncties

format_date

Maakt van een UNIX-epoch (in milliseconden) een datum/tijd-tekst.

Argument Type Verplicht Beschrijving
value number ja UNIX-epoch in milliseconden (via de pipe)
format string ja .NET-formaatstring (bijv. 'dd-MM-yyyy', 'HH:mm', 'dd-MM-yyyy HH:mm')
locale string nee Afwijkende locale (bijv. 'nl-NL', 'en-US'). Standaard de locale van de applicatie
timezone string nee Afwijkende IANA-tijdzone (bijv. 'Europe/Amsterdam'). Standaard de tijdzone van de applicatie
{{ vm.date | format_date 'dd-MM-yyyy' }}
{{ vm.date | format_date 'MMMM dd, yyyy h:mm tt' 'en-US' 'America/Chicago' }}

format_integer

Maakt een geheel getal op met duizendtalscheidingstekens volgens de locale.

Argument Type Verplicht Beschrijving
value number ja Het getal dat opgemaakt wordt (via de pipe)
locale string nee Afwijkende locale. Standaard de locale van de applicatie
{{ vm.count | format_integer }}
{{ vm.count | format_integer 'en-US' }}

format_decimal

Maakt een decimaal getal op met duizendtal- en decimaalscheidingstekens volgens de locale.

Argument Type Verplicht Beschrijving
value number ja Het getal dat opgemaakt wordt (via de pipe)
decimalPlaces int ja Aantal decimalen
locale string nee Afwijkende locale. Standaard de locale van de applicatie
{{ vm.price | format_decimal 2 }}
{{ vm.price | format_decimal 0 'en-US' }}

format_currency

Maakt een getal op als geldbedrag, met plaatsing van het valutasymbool en scheidingstekens volgens de locale.

Argument Type Verplicht Beschrijving
value number ja Het bedrag dat opgemaakt wordt (via de pipe)
decimalPlaces int ja Aantal decimalen
currencyCode string ja ISO 4217-valutacode (bijv. 'EUR', 'USD'). Een onbekende code wordt letterlijk als symbool gebruikt
locale string nee Afwijkende locale. Standaard de locale van de applicatie
{{ vm.price | format_currency 2 'EUR' }}
{{ vm.price | format_currency 2 'USD' 'en-US' }}

format_percentage

Maakt een fractie op als percentage (vermenigvuldigt met 100).

Argument Type Verplicht Beschrijving
value number ja De fractie die opgemaakt wordt (via de pipe), bijv. 0.153 wordt 15.3%
decimalPlaces int ja Aantal decimalen
locale string nee Afwijkende locale. Standaard de locale van de applicatie
{{ vm.ratio | format_percentage 1 }}
{{ vm.ratio | format_percentage 0 'en-US' }}