Referenz
Formatierer
Die 12 Formatierer und die 5 Summenfunktionen von Brevier, jeweils mit Eingabe, Ausgabe und der Regel, nach der sie arbeiten.
Auf dieser Seite
Ein Formatierer ändert, wie ein Wert erscheint. Er steht hinter einem
senkrechten Strich: {{ betrag | money }}. Formatierer laufen von links
nach rechts.
money,date,number,intund die DIN-5008-Formatierer liefern Anzeigetext. Ein zweiter davon hinter dem ersten schlägt fehl, weil der Text keine Zahl mehr ist:{{ x | money | number }}.uppercaseliest jeden Text und kann deshalb hinter jedem Formatierer stehen:{{ tag | date | uppercase }}.- Eine Summenfunktion steht an erster Stelle.
- Passt ein Wert nicht zum Formatierer, schlägt der Aufruf fehl. Die Meldung nennt den Wert und die Zeile in der Vorlage.
brevier pdf, brevier html und brevier serve lesen eine JSON-Zahl wie
1234.5 exakt. money, number, eur und die Summenfunktionen lehnen
einen Python-float ab.
Die Python-Methode with_json des Builder und brevier preview lesen
1234.5 als float. Dort und in Python-Code schreiben Sie die Zahl als Text
("1234.5") oder übergeben einen int oder einen Decimal.
iban, bic, blz, postfach, time und phone brauchen Text. Eine
JSON-Zahl schlägt fehl.
Die Leerzeichen in den Ausgaben unten sind geschützte Leerzeichen, damit ein Wert nie umbricht.
Formatierer
| Formatierer | Eingabe | Ausgabe | Wirkung |
|---|---|---|---|
money |
"1234.5" |
1.234,50 € |
Deutscher Betrag mit 2 Nachkommastellen, ab 0,5 aufgerundet. |
date |
"2026-10-25" |
25.10.2026 |
ISO-8601-Datum oder -Zeitpunkt als TT.MM.JJJJ. |
number |
"1234567" |
1 234 567 |
Dreiergruppen, wie DIN 5008 Zahlen schreibt. Eine Zahl mit 4 Stellen vor dem Komma wird nicht gruppiert. Nachkommastellen bleiben. |
int |
"1500" |
1500 |
Wie number. Nachkommastellen schneidet er nicht ab. |
uppercase |
"Müller" |
MÜLLER |
Großbuchstaben. ß wird zu SS. |
iban |
"de89370400440532013000" |
DE89 3704 0044 0532 0130 00 |
Vierergruppen. Er prüft die Form, nicht die Prüfziffern. |
bic |
"erfbde8e759" |
ERFBDE8E759 |
Großbuchstaben, 8 oder 11 Zeichen. |
blz |
"37040044" |
370 400 44 |
Eine deutsche Bankleitzahl mit 8 Ziffern, in Gruppen zu 3, 3 und 2. |
postfach |
"123456" |
12 34 56 |
Eine Postfachnummer in Zweiergruppen, von rechts gezählt. |
time |
"14:05" |
14:05 Uhr |
Eine Uhrzeit mit Uhr. Sekunden bleiben nur, wenn sie nicht null sind: 14:05:30 Uhr. |
eur |
"1234.5" |
1.234,50 EUR |
Ein Betrag mit den Buchstaben EUR und ohne Eurozeichen. |
phone |
"05444/347687-350" |
05444 347687-350 |
Eine Telefonnummer in der Schreibweise nach DIN 5008. Ein Bindestrich vor der letzten Gruppe kennzeichnet die Durchwahl. Die Vorwahl muss durch ein Trennzeichen abgesetzt sein, außer bei einer Mobilnummer oder einer Nummer mit 0180 oder 0900. |
Summen
Eine Summenfunktion liest eine Liste und gibt eine Zahl aus. Sie muss der
erste Formatierer im Tag sein. {{ zeilen.preis | sum }} liest den preis
jeder Zeile von zeilen.
Eine Summenfunktion liefert eine Zahl. Danach können money, number,
int oder eur folgen: {{ zeilen.preis | sum | money }}. Siehe
ADR-038.
| Summe | Eingabe | Ausgabe | Wirkung |
|---|---|---|---|
count |
["a", "b", "c"] |
3 |
Die Anzahl der Einträge. Sie nimmt jede Liste. |
sum |
["10", "2.5", "3"] |
15.5 |
Die Summe. Eine leere Liste ergibt 0. |
avg |
["10", "2.5", "3"] |
5.2 |
Der Durchschnitt, ab 0,5 aufgerundet. Eine leere Liste gibt nichts aus. |
min |
["10", "2.5", "3"] |
2.5 |
Die kleinste Zahl. Eine leere Liste gibt nichts aus. |
max |
["10", "2.5", "3"] |
10 |
Die größte Zahl. Eine leere Liste gibt nichts aus. |