Formats a number
into a currency string (e.g., $13.65). Youcan customize the format in the options
hash.
Options
-
:locale
- Sets the locale to be used for formatting (defaultsto current locale). -
:precision
- Sets the level of precision (defaults to 2). -
:unit
- Sets the denomination of the currency (defaults to"$"). -
:separator
- Sets the separator between the units (defaults to"."). -
:delimiter
- Sets the thousands delimiter (defaults to ","). -
:format
- Sets the format for non-negative numbers (defaultsto "%u%n"). Fields are%u
for the currency, and%n
for the number. -
:negative_format
- Sets the format for negative numbers(defaults to prepending an hyphen to the formatted number given by:format
). Accepts the same fields than:format
,except%n
is here the absolute value of the number.
Examples
number_to_currency(1234567890.50) # => $1,234,567,890.50
number_to_currency(1234567890.506) # => $1,234,567,890.51
number_to_currency(1234567890.506, precision: 3) # => $1,234,567,890.506
number_to_currency(1234567890.506, locale: :fr) # => 1 234 567 890,51 €
number_to_currency('123a456') # => $123a456
number_to_currency(-1234567890.50, negative_format: '(%u%n)')
# => ($1,234,567,890.50)
number_to_currency(1234567890.50, unit: '£', separator: ',', delimiter: '')
# => £1234567890,50
number_to_currency(1234567890.50, unit: '£', separator: ',', delimiter: '', format: '%n %u')
# => 1234567890,50 £