(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 format `format` (optional) - The formatting pattern to use for the number, see DecimalFormat `formatName` (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 value `groupingUsed` (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. | Quick Reference (hide)