Altova MapForce 2025 Professional Edition

Konvertiert einen Wert vom Typ xs:dateTime in einen String. Die String-Darstellung von Datum und Uhrzeit wird entsprechend dem Wert des Arguments format formatiert.

Sprachen

Built-in, C++, C#, Java, XSLT 2.0, XSLT 3.0.

Parameter

Anmerkung: Wenn die Ausgabe der Funktion (result) mit einem Node verbunden ist, dessen Typ nicht string ist, kann die Formatierung verloren gehen, da der Wert in den Zieltyp konvertiert wird. Diese automatische Konvertierung kann durch Deaktivieren des Kontrollkästchens Zielwerte in Zieltypen konvertieren in den Komponenteneinstellungen der Zielkomponente deaktiviert werden.

Formatierung

Das Argument format besteht aus einem String, der so genannte Variablen-Marker enthält, die innerhalb von eckigen Klammern stehen, z.B. [J]/[M]/[T]. Zeichen außerhalb von eckigen Klammern sind Literalzeichen. Wenn das Ergebnis eckige Klammern als Literalzeichen enthalten soll, so sollten diese eckigen Klammern verdoppelt werden.

Jeder Variablen-Marker besteht aus den folgenden Teilen:

•einem Specifier, der angibt, welcher Teil des Datentyps angezeigt werden soll (d.h. Datum oder Uhrzeit),

•einem optionalen Formatierungs-Modifikator,

•einem optionalen Darstellungs-Modifikator und

•einem optionalen Breiten-Modifikator, dem, falls vorhanden, ein Komma vorangestellt werden muss.

Specifier

Die verfügbaren Specifier sind in der Tabelle unten beschrieben.

Formatierungs-Modifikatoren

Als Formatierungs-Modifikator kann eines der folgenden Zeichen verwendet werden:

Achtung

Die Modifikatoren N, n und Nn werden von den folgenden Specifiern unterstützt: M, F und P. Die Modifikatoren N, n und Nn werden auch von den z-Specifiern unterstützt, jedoch nur in Built-In und bei der Codegenerierung: (Professional und Enterprise Edition).

Wenn Sie einen Breiten-Modifier benötigen, stellen Sie diesem ein Komma voran. Der Breiten-Modifier ist eine Zahl, die für die Mindestbreite steht. Optional können Sie einen Bindestrich und eine weitere Zahl, die die Maximalbreite angibt, hinzufügen. Beispiel:

•[D,2] ist der Tag des Monats mit einer vorangestellten Null (zwei Stellen).

•[MNn,3-3] ist der Name des Monats in Form einer Abkürzung bestehend aus drei Buchstaben, z.B. Jan, Feb, Mar usw.

Beispiele

In der nachstehenden Tabelle sehen Sie einige Beispiele für die Formatierung von xs:dateTime-Werten mit Hilfe der format-dateTime-Funktion. In der Spalte Wert finden Sie den Wert, der für das Argument value bereitgestellt wird. In der Spalte Format ist der Wert des Arguments format angegeben. In der Spalte Ergebnis finden Sie das Ergebnis der Funktion.