Determines whether a string is a valid representation of a currency amount in the current locale.
True, if the parameter is formatted as a valid currency amount, including the appropriate currency indicator. The return value is True for amounts in the local, international, or none currency formats.
1 | LSIsCurrency(string [, locale]) |
ColdFusion 8: Added the locale parameter.
ColdFusion MX: Changed formatting behavior: this function might return a different result than in earlier releases. This function uses Java standard locale formatting rules on all platforms; the results might vary depending upon the JVM; for example, Sun JVM 1.4.1 requires euro format the local currency if the current locale's country belongs to the Euro Zone.
Parameter |
Description |
|---|---|
string |
A currency string or a variable that contains one. |
locale |
Locale to use instead of the locale of the page when processing the function |
For examples of ColdFusion code and output that shows differences between earlier ColdFusion releases and ColdFusion MX in accepting input formats and displaying output, see LSCurrencyFormat.
Note:
If the locale belongs to a Euro zone country and the currency is a correctly formatted euro value for the locale, this function returns True for all JVMs, including Sun 1.3.1. As a result, with 1.3.1-compliant JVMs, the LSIsCurrency function does not ensure that LSParseCurrency returns a value. If a currency uses the older country-specific format for Euro Zone locales, the LSIsCurrency function returns False for newer JVMs, such as Sun 1.4.1 and 1.6, and True for older JVMs, such as Sun 1.3.1.
Note:
To set the default display format of date, time, number, and currency values, use the SetLocale function.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | <h3>LSIsCurrency Example</h3> <cfif IsDefined("FORM.locale")> <!--- if locale is defined, set locale to that entry ---><cfset NewLocale = SetLocale(FORM.locale)> <p>Is the value "<cfoutput>#FORM.myValue#</cfoutput>"a proper currency value for <cfoutput>#GetLocale()#</cfoutput>? <p>Answer: <cfoutput>#LSIsCurrency(FORM.myValue)#</cfoutput> </cfif> <p><form action = "LSIsCurrency.cfm"> <p>Select a locale for which you would like to check a currency value: <!--- check the current locale for server ---><cfset serverLocale = GetLocale()> |
Twitter™ and Facebook posts are not covered under the terms of Creative Commons.