Altova MapForce 2024 Enterprise Edition

Converts a value of type xs:dateTime to a string. The string representation of date and time is formatted according to the value of the format argument.

Languages

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

Parameters

Remarks

The format argument consists of a string containing so-called variable markers enclosed in square brackets, for example [Y]/[M]/[D]. Characters outside the square brackets are literal characters. If square brackets are needed as literal characters in the result, then they should be doubled.

Each variable marker consists of a component specifier identifying which component of the date or time is to be displayed, an optional formatting modifier, another optional presentation modifier and an optional width modifier, preceded by a comma if it is present.

The components are as follows:

The formatting modifier can be one of the following:

Footnotes:

1. The N, n, and Nn modifiers are supported by the following components only: M, d, D.

The width modifier, if necessary, is introduced by a comma, followed by a digit that expresses the minimum width. Optionally, you can add a dash followed by another digit that expresses the maximum width. For example:

•[D,2] is the day of the month, with leading zeros (two digits).

•[MNn,3-3] is the name of the month, written as three characters, e.g. Jan, Feb, Mar, and so on.

Examples

The table below illustrates some examples of formatting xs:dateTime values with the help of the format-dateTime function. The "Value" column specifies the value supplied to the value argument. The "Format" column specifies the value of the format argument. The "Result" column illustrates what is returned by the function.