Kurzbeschreibung

Das XML-Element <Converter> dient dazu, Werte in ein anderes Format zu überführen.

Es wird verwendet, wenn ein Datums- oder Zahlenwert zunächst an ein gewünschtes Format angepasst werden muss, bevor er ausgegeben oder von einer anderen Funktion weiterverarbeitet wird.

Typische Einsatzgebiete sind Datums- und Zahlenkonvertierungen.

Einordnung

Bereich: Funktionen

Schwierigkeitsgrad: ⭐⭐⭐☆☆

Vorkenntnisse: Variable

Siehe auch

• Variable
• Math
• DateAdd

Zweck

Nicht alle Werte liegen automatisch im benötigten Format vor.

Der <Converter> ermöglicht es, Datums- oder Zahlenwerte in ein gewünschtes Zielformat zu überführen.

Dadurch können beispielsweise

• Datumswerte vereinheitlicht,
• Zahlenformate angepasst,
• internationale Zahlenformate umgewandelt oder
• Werte für weitere Funktionen vorbereitet werden.

Grundsyntax

<Converter
    DataType="Datum"
    SourceFormat="yyyy-MM-dd"
    TargetFormat="dd.MM.yyyy">

    <Variable Path="custom.datum">
    </Variable>

</Converter>

Der zu konvertierende Wert wird innerhalb des <Converter> angegeben.

Das Ergebnis wird unmittelbar an der Position des XML-Elements ausgegeben.

Position innerhalb der Dokumentvorlage

Da <Converter> einen Wert zurückliefert, wird das XML-Element innerhalb eines <Content> verwendet.

<Block>

    <Content>

        <Converter
            DataType="Numerisch"
            SourceFormat="#,###.##"
            TargetFormat="#.###,##">

            <Variable Path="custom.betrag">
            </Variable>

        </Converter>

    </Content>

</Block>

Attribute

Hinweis

Die Formatangaben orientieren sich an den üblichen Datums- und Zahlenformaten. Es existieren keine fest vorgegebenen Formatmasken.

Datentypen

Aktuell unterstützt <Converter> zwei Datentypen.

Je nach Datentyp werden SourceFormat und TargetFormat unterschiedlich interpretiert.

SourceFormat und TargetFormat

Mit SourceFormat und TargetFormat wird festgelegt,

• wie der Eingabewert aufgebaut ist und
• wie der Ausgabewert dargestellt werden soll.

Dabei können die allgemein üblichen Formatmasken verwendet werden.

Beispiele für Datumsformate

Beispiele für Zahlenformate

Hinweis

SourceFormat beschreibt immer das Format des Eingabewertes.

TargetFormat beschreibt das gewünschte Format der Ausgabe.

Unterelemente

Innerhalb des <Converter> befindet sich der zu konvertierende Wert.

In den meisten Fällen wird hierfür eine Variable verwendet.

<Converter
    DataType="Datum"
    SourceFormat="yyyy-MM-dd"
    TargetFormat="dd.MM.yyyy">

    <Variable Path="custom.datum">
    </Variable>

</Converter>

Grundsätzlich können alle XML-Elemente verwendet werden, die einen Datums- oder Zahlenwert zurückliefern.

Beispiele

Datum umwandeln

<Converter
    DataType="Datum"
    SourceFormat="yyyy-MM-dd"
    TargetFormat="dd.MM.yyyy">

    <Variable Path="custom.datum">
    </Variable>

</Converter>

Ein Eingabewert

2026-08-04

wird zu

04.08.2026

Internationales Zahlenformat

<Converter
    DataType="Numerisch"
    SourceFormat="#,###.##"
    TargetFormat="#.###,##">

    <Variable Path="custom.betrag">
    </Variable>

</Converter>

Ein Eingabewert

12,345.67

wird zu

12.345,67

Typische Einsatzgebiete

Der <Converter> wird häufig verwendet, um

• Datumswerte für die Ausgabe umzuwandeln,
• internationale Zahlenformate anzupassen,
• Werte für Berechnungen vorzubereiten,
• Datumswerte vor einer DateAdd-Berechnung zu konvertieren,
• Zahlenwerte vor einer Math-Berechnung aufzubereiten.

Zusammenspiel mit anderen Funktionen

Der <Converter> wird häufig gemeinsam mit anderen Funktionen verwendet.

Vorbereitung einer Datumsberechnung

Variable
      │
      ▼
Converter
      │
      ▼
DateAdd

Ein Datumswert wird zunächst in das erwartete Format konvertiert und anschließend weiterverarbeitet.

Vorbereitung einer Berechnung

Variable
      │
      ▼
Converter
      │
      ▼
Math

Ein Zahlenwert wird zunächst in ein geeignetes Zahlenformat überführt und anschließend berechnet.

Best Practices

• Datums- und Zahlenwerte möglichst früh in das benötigte Format konvertieren.
• SourceFormat immer passend zum tatsächlichen Eingabewert wählen.
• TargetFormat an die gewünschte Darstellung anpassen.
• Für Berechnungen möglichst bereits konvertierte Werte verwenden.
• Die Dokumentvorschau nach einer Formatumwandlung prüfen.

XML-Wissen

Der <Converter> verändert den ursprünglichen Wert nicht.

Stattdessen wird ein neuer Wert erzeugt und unmittelbar ausgegeben.

Soll dieser Wert später erneut verwendet werden, kann er beispielsweise mit einem <Setter> gespeichert und anschließend über eine <Variable> wieder ausgegeben werden.

Developer-Tipp

Der <Converter> eignet sich hervorragend als Vorbereitung für andere XML-Funktionen.

Werden Datums- oder Zahlenwerte bereits früh in ein einheitliches Format überführt, lassen sich Berechnungen und Ausgaben wesentlich einfacher und zuverlässiger erstellen.