(Quick Reference)
formatNumber
Purpose
Formats a number using the patterns defined by the
DecimalFormat class. Also supports attributes used in the JSTL
formatNumber tag.
Examples
<g:formatNumber number="${myNumber}" format="\\$###,##0" />Example of formatting an EUR currency amount:
<g:formatNumber number="${myCurrencyAmount}" type="currency" currencyCode="EUR" />Example of formatting a USD currency amount:
<g:formatNumber number="${myCurrencyAmount}" type="currency" currencyCode="USD" />For USD, the currency symbol will be based on the locale of the request. For the "en_US" locale, the result is "$123.45" and for "fi_FI" locale, the formatting is "123,45 USD". The formatting rules come from the
Currency class.
Example of left padding a number with zeros:
<g:formatNumber number="${myNumber}" type="number" minIntegerDigits="9" />Example of formatting a number showing 2 fraction digits:
<g:formatNumber number="${myNumber}" type="number" maxFractionDigits="2" />Example of formatting a number showing 2 fraction digits, rounding with RoundingMode.HALF_DOWN:
<g:formatNumber number="${myNumber}" type="number"
maxFractionDigits="2" roundingMode="HALF_DOWN" />Description
Attributes
number (required) - The number object to formateformat (optional) - The formatting pattern to use for the number, see DecimalFormatformatName (optional) - Look up format from the default MessageSource / ResourceBundle (i18n/.properties file) with this key. Look up format from the default MessageSource / ResourceBundle (i18n/.properties file) with this key. If format and formatName are empty, format is looked up with 'default.number.format' key. If the key is missing, '0' formatting pattern is used.type (optional) - The type of formatter to use: 'number', 'currency' or 'percent' . format or formatName aren't used when type is specified.locale (optional) - Override the locale of the request , String or Locale valuegroupingUsed (optional) - Set whether grouping will be used in this format.minIntegerDigits (optional) - Sets the minimum number of digits allowed in the integer portion of a number.maxIntegerDigits (optional) - Sets the maximum number of digits allowed in the integer portion of a number.minFractionDigits (optional) - Sets the minimum number of digits allowed in the fraction portion of a number.maxFractionDigits (optional) - Sets the maximum number of digits allowed in the fraction portion of a number.currencyCode (optional) - The standard currency code ('EUR', 'USD', etc.), uses formatting settings for the currency. type='currency' attribute is recommended.currencySymbol (optional) - Force the currency symbol to some symbol, recommended way is to use currencyCode attribute instead (takes symbol information from Currency)roundingMode (optional) - Sets the RoundingMode used in this DecimalFormat. Usual values: HALF_UP, HALF_DOWN. If roundingMode is UNNECESSARY and an ArithemeticException occurs, the original number formatted with default number formatting will be returned.
Source
