Altova MapForce 2025 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

Formatting

The format argument consists of a string that contains variable markers enclosed in square brackets (e.g., [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 the following parts:

•a specifier identifying which part of the data type is to be displayed (i.e., date or time),

•an optional formatting modifier,

•an optional presentation modifier, and

•an optional width modifier, which must be preceded by a comma if it is present.

Specifiers

The available specifiers are described in the table below.

Formatting modifiers

The formatting modifier can be any of the following:

Important

The N, n, and Nn modifiers are supported by the following specifiers: M, F, and P. The N, n, and Nn modifiers are also supported by the z specifier but only in Built-In and code generation (Professional and Enterprise editions).

If you need a width modifier, put a comma before it. The width modifier is a digit that expresses the minimum width. Optionally, you can add a dash and a 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 shows what is returned by the function.