Sprache und Zeitzone

Worum es geht

Ein Dokument hat eine Sprache und eine Zeitzone. Die Sprache entscheidet zwei Dinge: welche Sprachvariante der Vorlage CRMS nimmt und wie Zahlen und Daten aussehen. Die Zeitzone entscheidet, welche Uhrzeit ein Zeitpunkt im Dokument zeigt.

Beides darfst du in der Anfrage angeben. Lässt du es weg, nimmt CRMS feste Rückfälle.

Woher die Sprache kommt

Mit dieser Sprache sucht CRMS die passende Sprachvariante der Vorlage: erst genau de-CH, dann de, dann die Standardvariante der Vorlage. Wie das im Einzelnen geht, steht unter Wie CRMS die Vorlage findet. Welche Variante gegriffen hat, steht im Antwort-Header Crms-Template-Variant.

Zahlen und Daten formatiert CRMS immer in der angefragten Sprache, auch wenn eine Variante einer anderen Sprache gegriffen hat. Im PDF setzt CRMS die Sprache als lang an das <html>-Element, wenn die Vorlage keins setzt. Barrierefreie PDFs brauchen das.

Woher die Zeitzone kommt

Eine eigene Zeitzonen-Einstellung für CRMS gibt es nicht. Bei FINAL legt CRMS Sprache und Zeitzone mit dem Dokument ab.

Wie Werte im Dokument aussehen

Die Vorlage formatiert mit FreeMarker. Sprache und Zeitzone sind dabei schon gesetzt. Mit der Payload {"amount": 1234.5, "n": 1234567, "flag": true, "due": "2026-10-17", "at": "2026-10-17T08:30:00Z"}, due als DATE und at als DATETIME deklariert, und der Zeitzone Europe/Berlin kommt heraus:

• ?c gibt eine Zahl ohne Formatierung aus, für Maschinen statt für Menschen. Das brauchst du etwa in Tabellenzellen, siehe Ausgabetypen und Formate.
• Wahrheitswerte kommen immer als true oder false. Willst du „ja“ und „nein“, schreibe ${flag?string('ja', 'nein')}.
• Der Zeitpunkt 08:30Z erscheint als 10:30, weil das Dokument in Europe/Berlin gerendert wird.
• Ein Kalenderdatum (DATE) gilt als Mitternacht in der Zeitzone des Dokuments. Es verschiebt sich darum nicht auf den Vortag.

Fallen

Weiter

• Wie CRMS die Vorlage findet
• Die Vorlagensprache
• Die Render-Anfrage