Cldr v0.0.19 Cldr.Number.Formatter.Currency

Number formatter for the :currency :long format.

This formatter implements formatting a currency in a long form. This is not the same as decimal formatting with a currency placeholder.

To explain the difference, look at the following examples:

iex> Cldr.Number.to_string 123, format: :currency, currency: "USD"
"$123.00"

iex> Cldr.Number.to_string 123, format: :long, currency: "USD"
"123 US dollars"

In the first example the format is defined by a decimal mask. In this example the format mask comes from:

iex> Cldr.Number.Format.all_formats_for("en").latn.currency
"¤#,##0.00"

In the second example we are using a format that combines the number with a language translation of the currency name. In this example the format comes from:

iex> Cldr.Number.Format.all_formats_for("en").latn.currency_long
%{one: [0, " ", 1], other: [0, " ", 1]}

Where “{0}” is replaced with the number formatted using the :standard decimal format and “{1} is replaced with locale-specific name of the currency adjusted for the locales plural rules.”

Summary

Functions

to_string(number, atom, options)