1.7 KiB
.numberParser( [options] ) ➜ function( value )
Return a function that parses a String representing a number according to the
given options. If value is invalid, NaN is returned.
The returned function is invoked with one argument: the String representing a
number value to be parsed.
Parameters
options Optional
A JSON object including none or any of the following options.
style Optional
String
decimal(default), orpercent.
value
String with number to be parsed, eg. "3.14".
Example
Prior to using any number methods, you must load
cldr/main/{locale}/numbers.json and cldr/supplemental/numberingSystems.json.
Read CLDR content if you need more information.
You can use the static method Globalize.numberParser(), which uses the
default locale.
var parser;
Globalize.locale( "en" );
parser = Globalize.numberParser();
parser( "3.14" );
// > 3.14
You can use the instance method .numberParser(), which uses the instance
locale.
var enParser = Globalize( "ar" ).numberParser(),
esParser = Globalize( "es" ).numberParser();
enParser( "3.14" );
// > 3.14
esParser( "3,14" );
// > 3.14
Some more examples.
var parser = Globalize( "en" ).numberParser();
parser( "12,735.00" );
// > 12735
parser( "6.626E-34" );
// > 6.626e-34
parser( "∞" );
// > Infinity
parser( "invalid-stuff" );
// > NaN
For improved performance on iterations, first create the parser. Then, reuse it on each loop.
var formattedNumbers = [ "1", "1", "2", "3", ... ];
var parser = Globalize( "en" ).numberParser();
numbers = formattedNumbers.map(function( formattedNumber ) {
return parser( formattedNumber );
});