ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Internationalizing applications
var nf:NumberFormatter = new NumberFormatter( "en-US" );
var inputNumberString:String = "The value is 123,456,7.890";
var parseResult:NumberParseResult = nf.parse(inputNumberString);
trace("Value:" + parseResult.value); // 1234567.89
trace("startIndex: " + parseResult.startIndex); // 14
trace("Status:" + nf.lastOperationStatus); // noError
The parse() method returns a NumberParseResult object that contains the parsed numeric value in its value property.
The startIndex property indicates the index of the first numeric character that was found. You can use the startIndex
and endIndex properties to extract the portions of the string that come before and after the digits.
Formatting currency values
Flash Player 10.1 and later, Adobe AIR 2.0 and later
The display formats of currency values vary as much as number formats do. For example, here is how the US dollar
value $123456.78 is formatted for certain locales:
Locale Number Format
en-US (English, USA) $123,456.78
de-DE (German, Germany) 123.456,78 $
en-IN (English, India) $ 1,23,456.78
Currency formatting involves all the same factors as number formatting, plus these additional factors:
Currency ISO code. The three letter ISO 4217 currency code for the actual locale being used, such as USD or EUR.
Currency symbol. The currency symbol or string for the actual locale being used, such as $ or €.
Negative currency format. Defines the location of the currency symbol and the negative symbol or parentheses in
relation to the numeric portion of the currency amount.
Positive currency format. Defines the location of currency symbol relative to the numeric portion of the currency
amount.
Using the CurrencyFormatter class
The CurrencyFormatter class formats numeric values into strings that contain currency strings and formatted
numbers, according to the conventions of a specific locale.
When you instantiate a new CurrencyFormatter object, it sets its currency to the default currency for the given locale.
The following example shows that a CurrencyFormatter object created using a German locale assumes that currency
amounts are in Euros:
var cf:CurrencyFormatter = new CurrencyFormatter( "de-DE" );
trace(cf.format(1234567.89)); // 1.234.567,89 EUR
In most cases, do not rely on the default currency for a locale. If the user’s default locale is not supported, then the
CurrencyFormatter class assigns a fallback locale. The fallback locale can have a different default currency. In addition,
you normally want the currency formats to look correct to your user, even if the amounts are not in the user’s local
currency. For example, a Canadian user can want to see a German company’s prices in Euros, but formatted in the
Canadian style.
Last updated 6/6/2012
945