Trinidad Core Tag Reference

9. Trinidad Core Tag Reference

<p>The <tr:convertNumber> tag is used to convert a string to a number object and back to a string based on pattern or type.</p>

Example

<tr:convertNumber> </tr:convertNumber>

HTML Output

(No output.)

Tag Attributes

currencyCode	Text

The ISO 4217 currency code, applied only when formatting currencies. Currency code can also be set for the entire application in trinidad-config.xml file. If currency code is not set on the converter, and if set on trinidad-config.xml configuration file it will be used by calling RequestContext().getCurrenctInstance().getCurrencyCode(). This currency code will be used during call to getAsString() for formatting, provided type is set to 'currency'.

currencySymbol	Text

Currency symbol, is applied only when formatting currencies. If currency code is set then symbol will be ignored.

groupingUsed	Text

Flag specifying whether formatted output will contain grouping separators. Default value is true.

id	Text

the identifier for the component

integerOnly	Text

Flag specifying whether only the integer part of the value will be formatted and parsed. Default value is false.

locale	Text

Locale whose predefined styles for numbers are used during formatting and parsing. If not specified, the Locale returned by FacesContext.getViewRoot().getLocale() will be used.

maxFractionDigits	Text

Maximum number of digits that will be formatted in the fractional portion of the output.

maxIntegerDigits	Text

Maximum number of digits that will be formatted in the integer portion of the output.

messageDetailConvertCurrency	Text

Custom error message to be used, for creating detail part of the FacesMessage, when value cannot be converted to a number, when type is set to 'currency' and pattern is null or not set. </p> <p> Parameters:<ul><li> {0} the label that identifies the component </li><li> {1} value entered by the user </li></ul>

messageDetailConvertNumber	Text

Custom error message to be used, for creating detail part of the FacesMessage, when value cannot be converted to a number, when type is set to 'number' and pattern is null or not set. </p> <p> Parameters:<ul><li> {0} the label that identifies the component </li><li> {1} value entered by the user </li></ul>

messageDetailConvertPattern	Text

Custom error message to be used, for creating detail part of the FacesMessage message, when value cannot be converted to a number, based on the pattern set. </p> <p> Parameters:<ul><li> {0} the label that identifies the component </li><li> {1} value entered by the user </li><li> {2} the specified conversion pattern </li></ul>

messageDetailConvertPercent	Text

Custom error message to be used, for creating detail part of the FacesMessage, when value cannot be converted to a number, when type is set to 'percent' and pattern is null or not set. </p> <p> Parameters:<ul><li> {0} the label that identifies the component </li><li> {1} value entered by the user </li></ul>

minFractionDigits	Text

Minimum number of digits that will be formatted in the fractional portion of the output.

minIntegerDigits	Text

Minimum number of digits that will be formatted in the integer portion of the output.

pattern	Text

Custom formatting pattern which determins how the number string should be formatted and parsed.

type	Text

Specifies how the number string will be formatted and parsed. Valid values are "number", "currency", and "percent". Default value is "number".

9. Trinidad Core Tag Reference