User Guide

LSParseNumber 769
LSParseNumber
Description
Converts a string that is a valid numeric representation in the current locale into a formatted
number.
Returns
A formatted number that matches the value of the string.
Category
International functions, String functions
Function syntax
LSParseNumber(string)
See also
LSParseDateTime
, SetLocale; “Locales” in Chapter 17, “Developing Globalized Applications”
in ColdFusion MX Developer’s Guide
History
ColdFusion MX: Changed formatting behavior: this function might return different formatting
than in earlier releases. This function uses Java standard locale formatting rules on all platforms.
Parameters
Usage
This function uses Java standard locale formatting rules on all platforms.
To set the default display format of date, time, number, and currency values, use the
SetLocale
function.
Example
<h3>LSParseNumber Example</h3>
<p>LSParseNumber converts a locale-specific string to a number.
Returns the number matching the value of string.
<!--- loop through a list of locales and show number values --->
<cfloop LIST = "#Server.Coldfusion.SupportedLocales#"
index = "locale" delimiters = ",">
<cfset oldlocale = SetLocale(locale)>
<cfoutput><p><B><I>#locale#</I></B><br>
#LSNumberFormat(-1234.5678, "_________")#<br>
#LSNumberFormat(-1234.5678, "_________.___")#<br>
#LSNumberFormat(1234.5678, "_________")#<br>
#LSNumberFormat(1234.5678, "_________.___")#<br>
#LSNumberFormat(1234.5678, "$_(_________.___)")#<br>
#LSNumberFormat(-1234.5678, "$_(_________.___)")#<br>
Parameter Description
string A string or a variable that contains one