NumberFormatter  - AS3

Nazwa bieżącego identyfikatora ustawień narodowych używanych przez dany obiekt klasy NumberFormatter.

Istnieją trzy możliwości dla wartości nazwy — w zależności od systemu operacyjnego i wartości parametru requestedLocaleIDName przekazywanego do konstruktora Collator().

1. Jeśli zażądano innych ustawień narodowych niż LocaleID.DEFAULT, a system operacyjny zapewnia obsługę dla żądanych ustawień, wówczas zwrócona nazwa będzie taka sama, jak właściwość requestedLocaleIDName.
2. Jeśli wartością parametru requestedLocaleIDName przekazanego do konstruktora było LocaleID.DEFAULT, wówczas używana będzie nazwa bieżących ustawień narodowych określonych przez system operacyjny użytkownika. Wartość LocaleID.DEFAULT powoduje zachowanie niestandardowych ustawień użytkownika w systemie operacyjnym. Przekazanie wartości jawnej jako parametru requestedLocaleIDName nie spowoduje uzyskania takiego samego rezultatu, jak użycie LocaleID.DEFAULT, nawet jeśli obydwa identyfikatory ustawień narodowych są takie same. Możliwe, że użytkownik dostosował ustawienia narodowe na własnym komputerze, a żądanie jawnego identyfikatora ustawień narodowych — zamiast LocaleID.DEFAULT — sprawi, że aplikacja nie odczyta tych niestandardowych ustawień.
3. Jeśli system nie obsługuje parametru requestedLocaleIDName określonego w konstruktorze, wówczas zostanie udostępniony identyfikator alternatywnych ustawień narodowych.

Powiązane elementy interfejsu API

Znak separatora dziesiętnego używanego w celu formatowania i analizowania liczb, które zawierają część dziesiętną.

Ta właściwość jest początkowo ustawiana na podstawie ustawień narodowych wybieranych podczas tworzenia obiektu formatera.

Jeśli do tej właściwości zostanie przypisana wartość i nie wystąpiły żadne błędy ani ostrzeżenia, wówczas właściwość lastOperationStatus zostaje ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Wartością domyślną jest dependent on the locale and operating system..

Powiązane elementy interfejsu API

Definiuje zbiór cyfr, który ma być używany do formatowania liczb.

W różnych językach i regionach używane są różne zestawy znaków, które reprezentują cyfry od 0 do 9. Ta właściwość definiuje zestaw cyfr do użycia.

Wartość tej właściwości reprezentuje wartość Unicode dla cyfry zero w zestawie cyfr dziesiętnych. Poprawne wartości dla tej właściwości są zdefiniowane w klasie NationalDigitsType.

Jeśli do tej właściwości zostanie przypisana wartość i nie wystąpiły żadne błędy ani ostrzeżenia, wówczas właściwość lastOperationStatus zostaje ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Wartością domyślną jest dependent on the locale and operating system..

Powiązane elementy interfejsu API

Maksymalna liczba cyfr, jakie mogą być widoczne po separatorze dziesiętnym.

Liczby będą zaokrąglane do liczby cyfr określonej przez tę właściwość. Schemat zaokrąglania zależy od systemu operacyjnego użytkownika.

Jeśli dla właściwości trailingZeros ustawiona jest wartość true, wówczas część ułamkowa liczby (po separatorze dziesiętnym) będzie wypełniana zerami końcowymi, aż długość będzie zgodna z wartością właściwości fractionalDigits.

Jeśli do tej właściwości zostanie przypisana wartość i nie wystąpiły żadne błędy ani ostrzeżenia, wówczas właściwość lastOperationStatus zostaje ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Wartością domyślną jest 0.

Powiązane elementy interfejsu API

Opisuje rozmieszczenie separatorów grup w sformatowanym ciągu liczby.

Jeśli właściwość useGrouping jest ustawiona na wartość true, wówczas właściwość groupingPattern będzie używana w celu definiowania rozmieszczenia i wzorca używanego dla separatora grup.

Wzorzec grupowania jest zdefiniowany jako ciąg znaków zawierających liczby rozdzielone średnikami, który opcjonalnie może kończyć się znakiem gwiazdki. Na przykład: "3;2;*". Każda liczba w ciągu znaków reprezentuje liczbę cyfr w grupie. Separator grupowania zostanie umieszczony przed każdą grupą cyfr. Gwiazdka na końcu ciągu znaków wskazuje, że grupy o takiej liczbie cyfr powinny być powtarzane w pozostałej części sformatowanego ciągu znaków. Jeśli gwiazdka nie występuje, wówczas pozostała część formatowanego ciągu znaków nie będzie zawierała dodatkowych grup ani separatorów.

Pierwsza liczba w ciągu znaków odpowiada pierwszej grupie cyfr po lewej stronie separatora dziesiętnego. Kolejne liczby definiują liczbę cyfr w kolejnych grupach po lewej stronie. Dlatego ciąg znaków "3;2;*" wskazuje, że separator grup zostanie umieszczony po pierwszej grupie 3 cyfr, a po nim znajdą się grupy zawierający po 2 cyfry. Na przykład: 98,76,54,321

Poniższa tabela zawiera przykłady formatowania liczby 123456789.12 z wykorzystaniem różnych wzorców grupowania. Separator grup to przecinek, a separator dziesiętny jest kropką.

Możliwe jest określenie tylko ograniczonej liczby wielkości grup. W niektórych systemach operacyjnych wzorce grupowania mogą zawierać dwie liczby oraz gwiazdkę. Inne systemy operacyjne mogą obsługiwać maksymalnie cztery liczby oraz gwiazdkę. W przypadku wzorców bez gwiazdki niektóre systemy operacyjne obsługują tylko jedną liczbę, a inne obsługują nawet trzy. Jeśli maksymalna liczba elementów wzorca grupowania zostanie przekroczona, wówczas dodatkowe elementy zostaną zignorowane, a właściwość lastOperationStatus zostanie ustawiona zgodnie z poniższym opisem.

Jeśli do tej właściwości zostanie przypisana wartość i nie wystąpiły żadne błędy ani ostrzeżenia, wówczas właściwość lastOperationStatus zostaje ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Powiązane elementy interfejsu API

Znak lub ciąg używany jako separator grup.

Wartość tej właściwości jest używana jako separator grup podczas formatowania liczby, jeśli właściwość useGrouping jest ustawiona na wartość true. Ta właściwość jest początkowo ustawiana na podstawie ustawień narodowych wybieranych podczas tworzenia obiektu formatera.

Jeśli do tej właściwości zostanie przypisana wartość i nie wystąpiły żadne błędy ani ostrzeżenia, wówczas właściwość lastOperationStatus zostaje ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Wartością domyślną jest dependent on the locale and operating system..

Powiązane elementy interfejsu API

Status poprzedniej operacji wykonanej przez ten obiekt NumberFormatter. Właściwość lastOperationStatus zostanie ustawiona przy każdym wywołaniu konstruktora lub metody tej klasy, a także w przypadku ustawienia innej właściwości. Możliwe wartości przedstawiają opisy poszczególnych metod.

Powiązane elementy interfejsu API

Określa, czy zero wiodące zostanie dołączone do formatowanej liczby, jeśli po lewej stronie separatora dziesiętnego nie ma żadnych cyfr całkowitych.

Jeśli dla tej właściwości ustawiona jest wartość true, wówczas po lewej stronie separatora dziesiętnego zostanie umieszczone zero wiodące, w przypadku formatowania wartości liczbowych z zakresu od –1,0 do 1,0. Jeśli dla właściwości ustawiona jest wartość false, zero wiodące nie zostanie dołączone.

Na przykład: w przypadku liczby 0,321 (jeśli dla właściwości ustawiona jest wartość true) zero wiodące zostanie dołączone do sformatowanego ciągu znaków. Jeśli dla właściwości ustawiona jest wartość false, zero wiodące nie zostanie dołączone. W takim przypadku ciąg znaków będzie zawierał tylko separator dziesiętny, a po nim cyfry — .321.

W poniższej tabeli przedstawiono przykłady sformatowanych wartości w oparciu o wartości tej właściwości i powiązane właściwości fractionalDigits i trailingZeros.

Jeśli do tej właściwości zostanie przypisana wartość i nie wystąpiły żadne błędy ani ostrzeżenia, wówczas właściwość lastOperationStatus zostaje ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Wartością domyślną jest dependent on the locale and operating system..

Powiązane elementy interfejsu API

Wartość liczbowa, która wskazuje wzorzec formatowania liczb ujemnych. Ten wzorzec definiuje lokalizację symbolu minusa lub nawiasów w relacji do części numerycznej formatowanej liczby.

W poniższej tabeli przedstawiono podsumowanie możliwych formatów liczb ujemnych. W sformatowanej liczbie ujemnej znak ujemny w formacie zostaje zastąpiony wartością właściwości negativeSymbol, a znak 'n' zostaje zastąpiony wartością sformatowanej liczby.

Jeśli do tej właściwości zostanie przypisana wartość i nie wystąpiły żadne błędy ani ostrzeżenia, wówczas właściwość lastOperationStatus zostaje ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Wartością domyślną jest dependent on the locale and operating system..

Powiązane elementy interfejsu API

Symbol ujemny do użytku w przypadku formatowania wartości ujemnych.

Podczas formatowania liczby mniejszej od zera ten symbol będzie używany z formatem liczby ujemnej. Nie jest on używany w formatach liczb ujemnych, które nie zawierają znaku ujemnego (np. gdy liczby ujemne są zawarte w nawiasach).

Dla tej właściwości zostanie ustawiona wartość domyślna dla rzeczywistych ustawień narodowych wybranych podczas tworzenia tego formatera. Ustawienie domyślne można zastąpić, ustawiając wartość.

Jeśli do tej właściwości zostanie przypisana wartość i nie wystąpiły żadne błędy ani ostrzeżenia, wówczas właściwość lastOperationStatus zostaje ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Powiązane elementy interfejsu API

Nazwa identyfikatora żądanych ustawień narodowych, która została przekazana do konstruktora obiektu klasy NumberFormatter.

Jeśli użyto wartości LocaleID.DEFAULT, wówczas zwrócona zostanie nazwa „i-default”. W przypadku zastosowania awaryjnych ustawień narodowych rzeczywiste ustawienia mogą się różnić od żądanych ustawień narodowych. Nazwę rzeczywistych ustawień narodowych można uzyskać za pomocą właściwości actualLocaleIDName.

Powiązane elementy interfejsu API

Określa, czy formatowana liczba będzie zawierała zera końcowe.

Jeśli dla tej właściwości ustawiona jest wartość true, zera końcowe będą uwzględniane w ułamkowej części formatowanej liczby do limitu określonego przez właściwość fractionalDigits. Jeśli ta właściwość jest ustawiona na false, zera końcowe nie są wyświetlane.

Na przykład: jeśli wartością liczbową jest 123,4, dla tej właściwości ustawiono wartość true, a właściwość fractionalDigits jest ustawiona na 3, wówczas sformatowany ciąg znaków będzie zawierał zera końcowe, tj. 123,400. Jeśli wartością tej właściwości jest false, zera końcowe nie będą dołączane, a ciąg znaków będzie zawierał tylko separator dziesiętny, a po nim liczby dziesiętne różne od zera, tj. 123,4.

W poniższej tabeli przedstawiono przykłady formatowana wartości liczbowych zgodnie z wartościami tej właściwości oraz powiązanymi właściwościami fractionalDigits i leadingZero.

Jeśli do tej właściwości zostanie przypisana wartość i nie wystąpiły żadne błędy ani ostrzeżenia, wówczas właściwość lastOperationStatus zostaje ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Wartością domyślną jest dependent on the locale and operating system..

Powiązane elementy interfejsu API

Umożliwia korzystanie z separatora grup podczas formatowania liczb.

Jeśli właściwość useGrouping jest ustawiona na true, wówczas cyfry są grupowane i ograniczone przez znak separatora grupowania. Na przykład: 123 456 789.22

Jeśli właściwość useGrouping jest ustawiona na false, wówczas cyfry nie są grupowane ani rozdzielane. Na przykład: 123456789.22

Symbol przeznaczony do użytku jako separator grupowania jest zdefiniowany przez właściwość groupingSeparator. Liczba cyfr między separatorami grupowania jest zdefiniowana przez właściwość groupingPattern.

Jeśli do tej właściwości zostanie przypisana wartość i nie wystąpiły żadne błędy ani ostrzeżenia, wówczas właściwość lastOperationStatus zostaje ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Powiązane elementy interfejsu API

Tworzony jest nowy obiekt NumberFormatter w celu formatowania liczb zgodnie z konwencjami określonych ustawień regionalnych.

Ten konstruktor określa, czy aktualny system operacyjny obsługuje żądane ustawienia narodowe identyfikowane przez identyfikator. Jeśli nie są obsługiwane, wówczas zostaną wykorzystane alternatywne ustawienia narodowe. Jeśli używane są alternatywne ustawienia narodowe, wówczas właściwość lastOperationStatus będzie wskazywała typ rozwiązania alternatywnego, a właściwość actualLocaleIDName będzie zawierała identyfikator alternatywnych ustawień narodowych.

W celu formatowania w oparciu o preferencje użytkownika dotyczące bieżącego systemu operacyjnego należy przekazać do konstruktora wartość LocaleID.DEFAULT w parametrze requestedLocaleIDName.

Jeśli działanie konstruktora zostanie pomyślnie zakończone, wówczas właściwość lastOperationStatus jest ustawiana na:

• LastOperationStatus.NO_ERROR

Jeśli identyfikator żądanych ustawień narodowych nie jest dostępny, wówczas właściwość lastOperationStatus zostanie ustawiona na jedną z poniższych wartości:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

Jeśli ta klasa nie jest obsługiwana w bieżącym systemie operacyjnym, wówczas właściwość lastOperationStatus jest ustawiana na:

• LastOperationStatus.UNSUPPORTED_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Szczegółowe informacje na temat ostrzeżeń przedstawionych powyżej oraz na temat innych możliwych wartości właściwości lastOperationStatus zawierają opisy w klasie LastOperationStatus.

Powiązane elementy interfejsu API

Formatuje wartość int. Ta funkcja jest równoważnikiem metody formatNumber(), ale uwzględnia wartość int. Jeśli przekazana wartość jest zbyt duża lub mała, np. wartość większa niż 1,72e308 lub mniejsza niż 1,72e-308, wówczas funkcja zwraca 0.

Jeśli działanie wywołanej metody zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Parametry

Powiązane elementy interfejsu API

Formatuje wartość Number.

Ta funkcja formatuje liczbę na podstawie wartości właściwości formatera. Jeśli właściwości nie zostaną zmodyfikowane po utworzeniu obiektu numberFormatter, wówczas liczby zostaną sformatowane zgodnie z konwencjami dotyczącymi ustawień narodowych udostępnionych przez system operacyjny dla ustawień narodowych wskazanych przez actualLocaleIDName. W celu dostosowania formatu właściwości mogą być modyfikowane w celu kontrolowania różnych aspektów formatowania liczby.

Ta funkcja może służyć do formatowania bardzo dużych liczb lub bardzo małych liczb. Jednak liczba cyfr znaczących jest ograniczona do precyzji, jaką zapewnia obiekt Number. Notacja naukowa nie jest obsługiwana.

Jeśli działanie wywołanej metody zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Parametry

Powiązane elementy interfejsu API

Formatuje wartość uint. Ta funkcja jest równoważnikiem metody formatNumber(), ale uwzględnia wartość uint. Jeśli przekazana wartość jest zbyt wysoka, np. większa niż 1,72e308, wówczas funkcja zwraca 0.

Jeśli działanie wywołanej metody zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Parametry

Powiązane elementy interfejsu API

Wyświetla listę identyfikatorów ustawień narodowych obsługiwanych przez tę klasę.

Jeśli ta klasa nie jest obsługiwana w bieżącym systemie operacyjnym, wówczas ta metoda zwróci wartość null.

Jeśli działanie wywołanej metody zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Analizuje ciąg i zwraca obiekt NumberParseResult zawierający elementy poddane analizie.

Obiekt NumberParseResult zawiera wartość pierwszej liczby znalezionej w wejściowym ciągu znaków, indeks początkowy dla liczby w ciągu znaków, a także indeks pierwszego znaku po liczbie w ciągu znaków.

Jeśli ciąg znaków nie zawiera liczby, wówczas właściwość value klasy NumberParseResult zostanie ustawiona na NaN, a właściwości startIndex i endIndex zostaną ustawione na wartość szesnastkową 0x7fffffff.

W tej funkcji wykorzystano wartość właściwości decimalSeparator w celu określenia tej części liczby, która zawiera cyfry ułamków; właściwość groupingSeparator w celu określenia, które znaki są dozwolone w cyfrach liczby; oraz właściwość negativeNumberFormat, aby kontrolować sposób reprezentowania wartości ujemnych.

Poniższa tabela identyfikuje wynik analizowania ciągów znaków dla różnych wartości NegativeNumberFormat:

Pojedynczy znak biały jest dozwolony między znakiem liczby a znakiem minusa lub nawiasem.

Podczas określania poprawnej liczby inne właściwości są ignorowane. Wartość właściwości digitsType jest ignorowana, a cyfry mogą należeć do dowolnych zestawów cyfr wyliczonych w klasie NationalDigitsType. Wartości właściwości groupingPattern i useGrouping nie wpływają na analizowanie liczby.

Jeśli po liczbach lub przed liczbami w ciągu znaków znajduje się znak '+', jest on traktowany jako znak, który nie jest częścią liczby.

Ta funkcja nie analizuje ciągów znaków zawierających liczby w notacji naukowej (np. 1,23e40).

Jeśli działanie wywołanej metody zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Parametry

Powiązane elementy interfejsu API

 
         var nf:NumberFormatter = new NumberFormatter("fr-FR"); 
         var str:String = "1,56 mètre"
         var result:NumberParseResult = nf.parse(str);
         trace(result.value) // 1.56
         trace(str.substr(0,result.startIndex));                // ""
         trace(str.substr(result.startIndex, result.endIndex)); // "1,56"
         trace(str.substr(result.endIndex));                    // " mètre"
         

Analizuje ciąg znaków zawierający tylko cyfry oraz opcjonalne znaki odstępów i zwraca obiekt Number. Jeśli ciąg znaków nie rozpoczyna się od liczby lub zawiera znaki inne niż znaki odstępu, które nie są częścią liczby, wówczas ta metoda zwraca NaN. Znak odstępu, który znajduje się przed lub po cyfrach liczby, jest ignorowany. Znak odstępu to znak, dla którego istnieje właściwość Space Separator (Zs) w bazie znaków Unicode (patrz http://www.unicode.org/ucd/).

Jeśli znak plusa '+' występuje przed lub po cyfrach liczby, jest on traktowany jako znak nie będący znakiem białym. Wartością zwracaną jest NaN.

Więcej informacji o analizach liczb oraz o składnikach poprawnej liczby zawiera opis funkcji analizowania.

Jeśli działanie wywołanej metody zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Parametry

Powiązane elementy interfejsu API

W tym przykładzie wykorzystywane są następujące ustawienia narodowe: domyślne (systemu operacyjnego) dla formatowania liczb, japońskie (Japonia), angielskie (USA) i francuskie (Francja). W przykładzie w celu wymuszenia domyślnych ustawień narodowych systemu operacyjnego użyto stałej LocaleID.DEFAULT.

Wyniki działania tego przykładu mogą być różne w zależności od systemu operacyjnego i ustawionych preferencji użytkownika.

Dla każdych ustawień narodowych na liście przykładowy kod wykonuje następujące czynności:

1. Tworzy nowy obiekt NumberFormatter.
2. Formatuje tę samą wartość na obiekt Number, liczbę całkowitą oraz liczbę całkowitą bez znaku i wyświetla wyniki.

 
package {
    import flash.globalization.NumberFormatter;
    import flash.globalization.LocaleID;
    
    public class NumberFormatterExample extends Sprite
    {
        public function NumberFormatterExample():void
        {
            var localeNames:Array = [LocaleID.DEFAULT,"ja_JP","en_US","fr_FR"];
            
            for ( var i:int = 0; i < localeNames.length; i++ ) 
            {
                var nf:NumberFormatter = new NumberFormatter( localeNames[i] as String );
                trace('\n\n' + "LocaleID requested: " + nf.requestedLocaleIDName 
                    + "; actual: " + nf.actualLocaleIDName);
                trace( "Last Operation Status:" + nf.lastOperationStatus );   
            
                var numberString:String = nf.formatNumber(123456789.19); 
                trace( "Formatted Number:" + numberString);
                numberString = nf.formatInt(-123456789); 
                trace( "Formatted Int:" + numberString);
                numberString = nf.formatUint(123456789); 
                trace( "Formatted UInt:" + numberString);
            }
        }
    }
}

Wyniki działania tego przykładu mogą być różne w zależności od systemu operacyjnego i ustawionych preferencji użytkownika.

Ten przykład wykonuje następujące operacje:

1. Tworzy nowy obiekt NumberFormatter.
2. Wywołuje metodę NumberFormatter.parse() w celu analizy ciągu znaków i zwraca obiekt NumberParseResult.
3. Wywołuje metodę NumberFormatter.parseNumber() w celu analizy ciągu znaków i zwraca wartość typu Number.

 
package {
      import flash.globalization.NumberFormatter;
      import flash.globalization.NumberParseResult;
      import flash.globalization.LastOperationStatus;
      import flash.globalization.LocaleID;

      public class NumberFormatterParseExample
      {
            public function NumberFormatterParseExample():void
            {
                var nf:NumberFormatter = new NumberFormatter( "en_US" );
                trace("LocaleID requested: " + nf.requestedLocaleIDName 
                    + "; actual: " + nf.actualLocaleIDName);
                trace( "Last Operation Status:" + nf.lastOperationStatus );  

                var inputNumberString:String = "123,567,89,0.254";
                var parseResult:NumberParseResult = nf.parse(inputNumberString);
                if ( nf.lastOperationStatus == LastOperationStatus.NO_ERROR ) {
                    trace("Parsed value:" + parseResult.value);
                }
                inputNumberString = "-123,567,89,0.254";
                var parsedNumber:Number = nf.parseNumber(inputNumberString);
                if ( nf.lastOperationStatus == LastOperationStatus.NO_ERROR ) {
                    trace("Parsed value:" + parsedNumber);
                }
            }
      }
}