Datenformatierung ist ein entscheidender Aspekt der Dokumentgenerierung und ermöglicht es Ihnen, Informationen so darzustellen, wie es Ihren spezifischen Anforderungen entspricht. Ob Datum, Zahlen oder andere Datentypen – die Kontrolle über ihre Darstellung verleiht Ihren Dokumenten Präzision und Professionalität.
Um Datenformatierungsfilter nutzen zu können, müssen Sie die erweiterte Syntax verwenden. Ohne Aktivierung werden die Formatierungsfilter bei der Dokumentgenerierung nicht angewendet.
1. Datum Formatieren 2. Zahlen Formatieren 3. In Großbuchstaben Umwandeln 4. In Kleinbuchstaben Umwandeln 5. Leerzeichen Entfernen
Einer der leistungsstärksten Formatierungsfilter ist der Datumsformatierer. Er ermöglicht es Ihnen zu steuern, wie Datumswerte in Ihren generierten Dokumenten erscheinen. Hier ist die Syntax, die Sie in Ihrer Vorlage verwenden müssen:
[source_date | date:'date_format']
Der Wert source_date muss im Format ISO 8601 vorliegen (ein internationaler Standard zur Darstellung von Datum und Uhrzeit). Ein Datum im Format yyyy-MM-dd funktioniert problemlos mit dem Datumsformatierer.
Das date_format gibt das gewünschte Ausgabeformat für das Datum an und basiert auf dem Unicode Technical Standard.
Angenommen, Sie haben ein Datum in Ihrem Datensatz wie dieses:
[{
"source_date": "2023-06-15"
}]
Mit dem Datumsformatierer in Ihrer Vorlage:
Date: [source_date | date:'dd-MM-yyyy']
Ergibt das:
Date: 15-06-2023
Hier einige weitere Formatierungsbeispiele:
| Format | Ergebnis | Beschreibung |
|---|---|---|
| dd-MM-yyyy | 15-06-2025 | Einfaches Datumsformat |
| dd/MM/yyyy | 15/06/2025 | Datumsformat mit Schrägstrichen |
| yyyy-MM-dd HH:mm | 2025-06-15 00:00 | Format mit Stunden und Minuten |
| yyyy-MM-dd HH:mm:ss | 2025-06-15 00:00:00 | Format mit Stunden, Minuten und Sekunden |
| eeee, yyyy-MM-dd | Friday, 2025-06-15 | Benutzerdefiniertes Format mit Wochentag |
| MMM yyyy | Jun 2025 | Kurzer Monatsname und Jahr |
| MMMM d, yyyy | June 15, 2025 | Vollständiger Monatsname mit Tag und Jahr |
Ein weiterer nützlicher Formatierungsfilter ist der Zahlenformatierer. Er ermöglicht es Ihnen zu steuern, wie Zahlen in Ihren generierten Dokumenten erscheinen. Hier ist die Syntax, die Sie in Ihrer Vorlage verwenden müssen:
[source_number | number:'digits_format':'locale']
Der Wert source_number kann eine Zahl oder eine Zeichenfolge sein, die eine Zahl repräsentiert.
digits_format gibt die dezimale Darstellung des Werts im folgenden Format an: {minIntegerDigits}.{minFractionDigits}-{maxFractionDigits}. {minIntegerDigits} ist optional, sodass es auch nur als {minFractionDigits}-{maxFractionDigits} angegeben werden kann. Dabei gilt: minIntegerDigits ist die Mindestanzahl von Ganzzahlstellen vor dem Dezimalzeichen. Ein Wert mit weniger Ganzzahlstellen als diese Zahl wird beim Formatieren links mit Nullen aufgefüllt (auf die angegebene Länge). Mögliche Werte: 1 bis 21. Standardwert: 1.minFractionDigits ist die Mindestanzahl von Stellen nach dem Dezimalzeichen. Mögliche Werte: 0 bis 20. Standardwert: 0.maxFractionDigits ist die maximale Anzahl von Stellen nach dem Dezimalzeichen. Mögliche Werte: 0 bis 20. Standardwert: 3.locale formatiert den Quellwert gemäß den Regeln des Gebietsschemas. Es ist ein optionaler Zeichenfolgenparameter mit einem BCP 47-Sprachtag. Der Standardwert ist en-US.Angenommen, Sie haben folgende Daten:
[{
"source_number": 3.14159265359
}]
Mit dem Zahlenformatierer in Ihrer Vorlage:
兀 with 3 decimals: [source_number | number]
兀 with 2 decimals: [source_number | number:'1.0-2']
Das Ergebnis:
兀 with 3 decimals: 3.142
兀 with 2 decimals: 3.14
Wie im Beispiel „Pi with 3 decimals” zu sehen ist, wird der Wert bei Verwendung des number-Filters ohne zusätzliche Parameter mit dem Standard-digits_format von 1.0-3 und dem Standard-locale von en-US formatiert.
Weitere Formatierungsbeispiele:
| Format | Ergebnis | Beschreibung |
|---|---|---|
| 2.0-2 | 03.14 | Mindestens 2 Stellen vor dem Dezimalzeichen und bis zu 2 Stellen danach. Führende Nullen werden bei Bedarf hinzugefügt. |
| 2-2 | 3.14 | Keine Anforderung für die Anzahl der Stellen vor dem Dezimalzeichen, aber genau 2 Stellen danach. |
| 4.0-2:en-US | 0,003.14 | Mindestens 4 Stellen vor dem Dezimalzeichen, bis zu 2 Stellen danach, formatiert nach dem en-US-Gebietsschema (Komma als Tausendertrennzeichen, Punkt als Dezimalzeichen). |
| 4.2-2:fr-FR | 0 003,14 | Mindestens 4 Stellen vor dem Dezimalzeichen, genau 2 Stellen danach, formatiert nach dem fr-FR-Gebietsschema (Leerzeichen als Tausendertrennzeichen, Komma als Dezimalzeichen). |
| 4.2-2:fr | 0 003,14 | Mindestens 4 Stellen vor dem Dezimalzeichen, genau 2 Stellen danach, mit französischer Formatierung. |
| 2 | 3.14159265359 | Falsches Format, der ursprüngliche Wert wird so angezeigt, wie er ist, ohne spezifische Zahlenformatierung. |
Um einen Text in Großbuchstaben umzuwandeln, verwenden Sie folgende Syntax in Ihrer Vorlage:
[source_text | upper]
Für folgenden Datensatz:
[{
"source_text": "Hello"
}]
Ergibt das:
HELLO
Um einen Text in Kleinbuchstaben umzuwandeln, verwenden Sie folgende Syntax in Ihrer Vorlage:
[source_text | lower]
Für folgenden Datensatz:
[{
"source_text": "Hello"
}]
Ergibt das:
hello
Leerzeichen umfassen Leerzeichen-, Tabulator-, geschützte Leerzeichen- und Zeilenendezeichen. Um Leerzeichen an beiden Enden einer Zeichenfolge zu entfernen, verwenden Sie folgende Syntax:
[source_text | trim]
Für folgenden Datensatz:
[{
"source_text": " Hello "
}]
Ergibt das:
Hello