Formats a given float to a currency representation.

= Examples =

<f:format.currency>123.456</f:format.currency>

123,46

<f:format.currency currencySign="$" decimalSeparator="." thousandsSeparator="," prependCurrency="false", separateCurrency="true", decimals="2">54321</f:format.currency>

54,321.00 $

{someNumber -> f:format.currency(thousandsSeparator: ',', currencySign: '')}

54,321,00 (depending on the value of {someNumber})

{someNumber -> f:format.currency(currencySign: '', forceLocale: true)}

54.321,00 (depending on the value of {someNumber} and the current locale)

{someNumber -> f:format.currency(currencySign: 'EUR', forceLocale: 'de_DE')}

54.321,00 EUR (depending on the value of {someNumber})

{someNumber -> f:format.currency(currencySign: '', prependCurrency: 'true')}

54.321,00 (depending on the value of {someNumber})

{someNumber -> f:format.currency(currencySign: '', separateCurrency: 'false', decimals: '0')}

54.321 (depending on the value of {someNumber})

Note: This ViewHelper is intended to help you with formatting numbers into monetary units. Complex calculations and/or conversions should be done before the number is passed.

Also be aware that if the `locale is set, all arguments except for the currency sign (which then becomes mandatory) are ignored and the CLDR (Common Locale Data Repository) is used for formatting. Fore more information about localization see section Internationalization & Localization Framework` in the Flow documentation.

Additionally, if `currencyCode` is set, rounding and decimal digits are replaced by the rules for the respective currency (e.g. JPY never has decimal digits, CHF is rounded using 5 decimals.)