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' }}