xsl:decimal-format

Indicates a set of localisation parameters. If the xsl:decimal-format element has a name attribute, it identifies a named format; if not, it identifies the default format.

Category: declaration
Content: none
Permitted parent elements: xsl:package ; xsl:stylesheet ; xsl:transform

Attributes

name?

eqname

A named format; if the attribute is omitted then the default format is used.

decimal-separator?

char

Specifies the character used to separate the integer part from the fractional part of the formatted number; the default is the period character (.).

grouping-separator?

char

Specifies the character typically used as a thousands separator; the default is the comma character (,).

infinity?

string

Specifies the string used to represent the xs:double value INF; the default is the string (Infinity).

minus-sign?

char

Specifies the character used to signal a negative number; the default is the hyphen-minus character (-).

exponent-separator?

char

Specifies the character used to separate the mantissa part from the exponent part of the formatted number; the default is the character (e). For use with XPath 3.1.

NaN?

string

Specifies the string used to represent the xs:double value Nan (not-a-number); the default is the string (NaN).

percent?

char

Specifies the character used to indicate that the number is represented as a per-hundred fraction; the default is the percent character (%).

per-mille?

char

Specifies the character used to indicate that the number is represented as a per-thousand fraction; the default is the Unicode per-mille character (#x2030).

zero-digit?

char

Specifies the character used to represent the digit zero; the default is the Western digit zero (0). Implicitly defines the characters used to represent each digit 0 to 9, as those in the corresponding Unicode decimal digit block.

digit?

char

Specifies the character used as a place-holder for an optional digit in the picture string; the default is the number sign character (#).

pattern-separator?

char

Specifies the character used to separate positive and negative sub-pictures in a picture string; the default is the semi-colon character (;).

Details

In practice decimal formats are used only for formatting numbers using the format-number() function in XPath expressions.

With XSLT 3.0, the specification of format-number() has moved into XPath which means it is also available in XQuery. The exponent-separator attribute is new in XPath 3.1, and allows formating of numbers in scientific notation.

Links to W3C specifications

XSLT 2.0 Specification

XSLT 3.0 Specification

See also

format-number()

xsl:number