Altova MapForce 2024 Enterprise 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

Anmerkungen

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 einem Komponenten-Specifier, der angibt, welche Komponente des Datums oder der Uhrzeit angezeigt werden soll, einem optionalen Formatierungs-Modifier, einem weiteren optionalen Darstellungs-Modifier und einem optionalen Breiten-Modifier. Vor diesen Modifiern steht, falls vorhanden, ein Komma.

Die Komponenten sind:

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

Fußnoten:

1. Die Modifier N, n und Nn werden nur von den folgenden Komponenten unterstützt: M, d, D.

Der Breiten-Modifier wird, falls erforderlich, durch ein Komma, gefolgt von einer Ziffer, die für die Mindestbreite steht, eingefügt. Optional können Sie einen Bindestrich, gefolgt von einer weiteren Ziffer, die die Maximalbreite angibt, hinzufügen. Zum 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.