<netui:formatNumber> Tag

A formatter used to format numbers.

Syntax

<netui:formatNumber
    [country="country"]
    [language="language"]
    [pattern="pattern"]
    [type="type"] />

Description

A formatter used to format numbers.

The <netui:formatNumber> tag formats the output of its parent tag. For example:

    <netui:label value="{price}">
        <netui:formatNumber country="FR" language="fr" type="currency" />
    </netui:label>

The pattern attribute conforms to java.text.DecimalFormat pattern syntax.

The pattern attribute uses the comma as a grouping separater. If many different grouping sizes are specified in one pattern, the right-most grouping interval will be used throughout; the other grouping intervals will be ignored. For example, the following format patterns all produce the same result. If the number to format is 123456789, each will produce 123,456,789.

The type attribute specifies three common kinds of formatting to be applied to the number. The valid values for the type attribute are:

The country attribute takes an upper-case, two-letter code as defined by ISO-3166. For a list of country codes see ISO-3166 Country Codes

The language attribute takes a lower-case, two-letter code as defined by ISO-639. For a list of ISO-639 language codes see ISO-639 Language Codes

Attributes
country
Required: No  |   Supports runtime evaluation: Yes  |   Data bindable:

language
Required: No  |   Supports runtime evaluation: Yes  |   Data bindable:

pattern
Required: No  |   Supports runtime evaluation: Yes  |   Data bindable:

type
Required: No  |   Supports runtime evaluation: Yes  |   Data bindable: No

The type of the format to apply. Possible values are number, currency, or percent.

 
Example

In this first example, the value "12345678" is formatted to 12,345,678.00.

    <netui:label value="12345678">
        <netui:formatNumber pattern="#,###.00" />
    </netui:label>

In the next sample, the value ".33" is formatted to 33%.

    <netui:label value=".33">
        <netui:formatNumber type="percent" />
    </netui:label>

In the next sample, the value "14.317" is formatted to $14.32.

    <netui:label value="14.317">
        <netui:formatNumber country="US" language="en" type="currency" />
    </netui:label>