ColdFusion 9.0 Resources |
LSParseEuroCurrencyDescriptionFormats a locale-specific currency string as a number. Attempts conversion through each of the default currency formats (none, local, international). Ensures correct handling of euro currency for Euro zone countries. See alsoLSParseCurrency, LSEuroCurrencyFormat, SetLocale; Locale-specific content in the Developing ColdFusion Applications HistoryColdFusion 8: Added the locale parameter. ColdFusion MX: Changed formatting behavior: this function might return different formatting than in earlier releases. This function uses Java locale formatting rules on all platforms, except that it uses the rule detailed in the Usage section for countries in the Euro currency zone. Parameters
UsageThis function determines whether the current locale’s country belongs to the Euro Zone, whose members have converted to the euro; if so, the currency-string parameter must be formatted in euros on all JVMs, including Sun JVM 1.3.1. If the country is not in the Euro zone, the string must follow the locale formatting rules of the JVM. For examples of valid currency formats in all supported locales, see LSEuroCurrencyFormat. For a list of the locale options that ColdFusion supports, and information on setting the default display format of date, time, number, and currency values, see SetLocale. Example<h3>LSParseEuroCurrency Example</h3> <p>Loop through all available locales. Create string representations of the value 123,456 in the three supported currency formats, and parse the results back to numbers.<p> <cfloop list="#Server.Coldfusion.SupportedLocales#" index="locale" delimiters=","> <cfset oldlocale = SetLocale(locale)> <cfoutput><p>Current Locale: <b><i>#locale#</i></b><br> <cfset localCurrency = LSEuroCurrencyFormat(123456, "local")> Value in local currency: #localCurrency#<br> Parsed using LSParseEuroCurrency: #LSParseEuroCurrency(localCurrency)#<br> <cfset IntlCurrency = LSEuroCurrencyFormat(123456, "international")> Value with International currency formatting: #IntlCurrency#<br> Parsed using LSParseEuroCurrency: #LSParseEuroCurrency(IntlCurrency)#<br> <cfset Currency = LSEuroCurrencyFormat(123456, "none")> Value with no currency formatting: #currency#<br> Parsed using LSParseEuroCurrency: #LSParseEuroCurrency(Currency)#<br> <hr noshade> </cfoutput> </cfloop> |