Data-opmaak is een cruciaal aspect van documentgeneratie, waarmee u informatie kunt presenteren op een manier die voldoet aan uw specifieke vereisten. Of het nu gaat om datums, getallen of andere datatypes, controle hebben over hun presentatie voegt een laag precisie en professionaliteit toe aan uw documenten.
Om data-opmaakfilters te gebruiken, moet u de uitgebreide syntax gebruiken. Als deze niet is ingeschakeld, worden de opmaakfilters niet toegepast tijdens de documentgeneratie.
1. Datums Opmaken
2. Getallen Opmaken
3. Omzetten naar Hoofdletters
4. Omzetten naar Kleine Letters
5. Witruimte Verwijderen
Een van de krachtige opmaakfilters die beschikbaar zijn, is de datumformatter. Hiermee kunt u bepalen hoe datums worden weergegeven in uw gegenereerde documenten. Dit is de syntax die u in uw sjabloon moet gebruiken:
[source_date | date:'date_format']
De waarde source_date moet in ISO 8601 -formaat zijn (een internationale standaard voor het weergeven van datums en tijden). Een datum opgegeven als yyyy-MM-dd werkt bijvoorbeeld naadloos met de datumformatter.
De date_format vertegenwoordigt het gewenste uitvoerformaat voor de datum, en is gebaseerd op de Unicode Technical Standard
Stel dat u een datum in uw dataset heeft zoals deze:
[{
"source_date": "2023-06-15"
}]
Gebruik van de datumformatter in uw sjabloon:
Date: [source_date | date:'dd-MM-yyyy']
Het resultaat wordt:
Date: 15-06-2023
Hier zijn nog enkele andere voorbeelden van opmaakopties:
| Formaat | Resultaat | Beschrijving |
|---|---|---|
| dd-MM-yyyy | 15-06-2025 | Basis Datumformaat |
| dd/MM/yyyy | 15/06/2025 | Basis Datumformaat met Schuine Strepen |
| yyyy-MM-dd HH:mm | 2025-06-15 00:00 | Formaat met Uren en Minuten |
| yyyy-MM-dd HH:mm:ss | 2025-06-15 00:00:00 | Formaat met Uren, Minuten en Seconden |
| eeee, yyyy-MM-dd | Friday, 2025-06-15 | Aangepast Formaat met Weekdag |
| MMM yyyy | Jun 2025 | Verkorte Maand en Jaar |
| MMMM d, yyyy | June 15, 2025 | Volledige Maandnaam met Dag en Jaar |
Een ander nuttig opmaakfilter is de getalformatter. Hiermee kunt u bepalen hoe getallen worden weergegeven in uw gegenereerde documenten. Dit is de syntax die u in uw sjabloon moet gebruiken:
[source_number | number:'digits_format':'locale']
De source_number kan zowel een getal als een tekenreeks zijn die een getal weergeeft.
digits_format geeft de decimale weergave van de waarde op in het volgende formaat:{minIntegerDigits}.{minFractionDigits}-{maxFractionDigits}.{minIntegerDigits} is optioneel, dus het is ook mogelijk om alleen {minFractionDigits}-{maxFractionDigits} op te geven, waarbij: minIntegerDigits het minimumaantal gehele cijfers vóór de komma is. Een waarde met minder gehele cijfers dan dit aantal wordt bij het opmaken links opgevuld met nullen (tot de opgegeven lengte). Mogelijke waarden lopen van 1 tot 21. De standaardwaarde is 1.minFractionDigits het minimumaantal cijfers na de komma is. Mogelijke waarden lopen van 0 tot 20. De standaardwaarde is 0.maxFractionDigits het maximumaantal cijfers na de komma is. Mogelijke waarden lopen van 0 tot 20. De standaardwaarde is 3.locale maakt de brontwaarde op volgens de regels van de landinstelling. Het is een optionele tekenreeksparameter met een BCP 47-taalcode. De standaardwaarde is en-US.Stel dat u een getal in uw dataset heeft zoals dit:
[{
"source_number": 3.14159265359
}]
Gebruik van de getalformatter in uw sjabloon:
兀 with 3 decimals: [source_number | number]
兀 with 2 decimals: [source_number | number:'1.0-2']
Het resultaat wordt:
兀 with 3 decimals: 3.142
兀 with 2 decimals: 3.14
Zoals u in het bovenstaande “Pi with 3 decimals”-voorbeeld kunt zien, wordt de waarde, als er geen extra parameters aan het number-filter worden meegegeven, opgemaakt met de standaard digits_format, namelijk 1.0-3, en de standaard locale, namelijk en-US.
Hier zijn nog enkele andere voorbeelden van opmaakopties:
| Formaat | Resultaat | Beschrijving |
|---|---|---|
| 2.0-2 | 03.14 | Minimaal 2 cijfers vóór de komma en maximaal 2 cijfers na de komma. Voorloopnullen worden indien nodig toegevoegd. |
| 2-2 | 3.14 | Geen vereiste voor het aantal cijfers vóór de komma, maar precies 2 cijfers na de komma. |
| 4.0-2:en-US | 0,003.14 | Minimaal 4 cijfers vóór de komma, maximaal 2 cijfers na de komma, en opgemaakt volgens de en-US-landinstelling, met een komma als duizendtalscheiding en een punt als decimaalteken. |
| 4.2-2:fr-FR | 0 003,14 | Minimaal 4 cijfers vóór de komma, precies 2 cijfers na de komma, en opgemaakt volgens de fr-FR-landinstelling, met een spatie als duizendtalscheiding en een komma als decimaalteken. |
| 4.2-2:fr | 0 003,14 | Minimaal 4 cijfers vóór de komma, precies 2 cijfers na de komma, en opgemaakt in Franse stijl, met een spatie als duizendtalscheiding en een komma als decimaalteken |
| 2 | 3.14159265359 | Onjuist formaat, de oorspronkelijke waarde wordt ongewijzigd weergegeven, zonder specifieke getalopmaak toe te passen. |
Om tekst om te zetten naar hoofdletters gebruikt u de volgende syntax in uw sjabloon:
[source_text | upper]
Voor de volgende dataset:
[{
"source_text": "Hello"
}]
Het resultaat wordt:
HELLO
Om tekst om te zetten naar kleine letters gebruikt u de volgende syntax in uw sjabloon:
[source_text | lower]
Voor de volgende dataset:
[{
"source_text": "Hello"
}]
Het resultaat wordt:
hello
Witruimte bestaat uit spaties, tabs, non-breaking spaces en regeleindetekens. Om witruimte aan beide uiteinden van een tekenreeks te verwijderen, gebruikt u de volgende syntax in uw sjabloon:
[source_text | trim]
Voor de volgende dataset:
[{
"source_text": " Hello "
}]
Het resultaat wordt:
Hello