CurrencyFormatter  - AS3

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

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

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

Trzyliterowy kod waluty ISO 4217 dla używanych ustawień narodowych.

Ten kod będzie używany w celu określenia symbolu lub ciągu znaków waluty podczas formatowania kwot w walutach za pomocą metody format() z parametrem withCurrencySymbol ustawionym na false.

Ta właściwość zostanie zainicjowana przez konstruktor na podstawie bieżących używanych ustawień narodowych. Jeśli używane są alternatywne ustawienia narodowe, ta właściwość będzie odzwierciedlać preferowany, domyślny kod walut dla alternatywnych ustawień narodowych.

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

Powiązane elementy interfejsu API

Symbol lub ciąg znaków waluty dla używanych ustawień narodowych.

Ta właściwość będzie używana jako symbol waluty podczas formatowania kwot w walutach za pomocą metody format() z parametrem withCurrencySymbol ustawionym na true.

Ta właściwość zostanie zainicjowana przez konstruktor na podstawie bieżących używanych ustawień regionalnych. Jeśli używane są alternatywne ustawienia narodowe, ta właściwość będzie odzwierciedlać preferowany, domyślny symbol waluty dla alternatywnych ustawień narodowych.

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

Powiązane elementy interfejsu API

Znak separatora dziesiętnego używanego w celu formatowania i analizowania kwot walut, 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 actual locale and operating system.

Powiązane elementy interfejsu API

Definiuje zbiór cyfr używanych w przypadku formatowania kwot walut.

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 actual 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 znaków kwoty.

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 kwoty 123456789.12 z wykorzystaniem różnych wzorców grupowania. Separatorem grupowania jest przecinek, separatorem dziesiętnym jest kropka, a znak dolara ($) jest symbolem waluty.

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 grupy podczas formatowania kwot w walutach, jeśli dla właściwości useGrouping ustawiona jest 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 actual locale and operating system.

Powiązane elementy interfejsu API

Status ostatniej operacji wykonanej przez ten obiekt CurrencyFormatter. 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 kwoty (w walucie), 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 kwoty 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 kwot 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 actual locale and operating system.

Powiązane elementy interfejsu API

Wartość liczbowa, która wskazuje wzorzec formatowania kwot ujemnych. Ten wzorzec definiuje położenie symbolu waluty oraz znaku ujemnego i nawiasów w odniesieniu do liczbowej części kwoty waluty.

Wartość tej właściwości musi być jedna ze stałych zdefiniowanych w poniższej tabeli.

Poniższa tabela podsumowuje możliwe wzorce formatowania dla ujemnych kwot w walutach. Gdy kwota jest formatowana metodą format():

• Symbol „¤” jest zastępowany wartością właściwości currencyISOCode lub właściwości currencySymbol — w zależności od wartości parametru withCurrencySymbol przekazywanego do metody format();
• Znak „-” jest zastępowany wartością właściwości negativeNumberSymbol;
• Znak „n” jest zastępowany wartością kwoty waluty, która jest przekazywana do metody format().

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 actual locale and operating system.

Powiązane elementy interfejsu API

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

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

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 actual locale and operating system.

Powiązane elementy interfejsu API

Wartość liczbowa, która wskazuje wzorzec formatowania kwot dodatnich. Ten format definiuje umiejscowienie symbolu waluty względem części liczbowej kwoty.

Wartość tej właściwości musi być jedna ze stałych zdefiniowanych w poniższej tabeli.

Poniższa tabela podsumowuje możliwe wzorce formatowania dla dodatnich kwot w walutach. Gdy kwota jest formatowana metodą format():

• Symbol „¤” jest zastępowany wartością właściwości currencyISOCode lub właściwości currencySymbol — w zależności od wartości parametru withCurrencySymbol przekazywanego do metody format();
• Znak „n” jest zastępowany wartością kwoty waluty, która jest przekazywana do metody format().

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 actual locale and operating system.

Powiązane elementy interfejsu API

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

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 sformatowana kwota 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 będą wyświetlane.

Na przykład: jeśli kwotą 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, np.: $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, np.: $123,4.

W poniższej tabeli przedstawiono przykłady sformatowanych kwot w oparciu o wartości tej właściwości i powiązane właściwości 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 actual locale and operating system.

Powiązane elementy interfejsu API

Umożliwia korzystanie z separatora grup podczas formatowania kwot.

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

Jeśli właściwość useGrouping jest ustawiona na false, wówczas cyfry nie będą grupowane ani rozdzielane. Na przykład: $123456789

Właściwość groupingSeparator definiuje symbol, który będzie służył jako separator grupowania. Właściwość groupingPattern definiuje liczbę cyfr między separatorami grupowania.

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

Tworzy nowy obiekt CurrencyFormatter w celu sformatowania liczb reprezentujących kwoty waluty 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.

Niektóre właściwości, takie jak currencySymbol i currencyISOCode będą ustawiane automatycznie zgodnie z ustawieniami narodowymi.

UWAGA: Gdy używane są alternatywne ustawienia narodowe, właściwości waluty przyjmują wartości domyślne, w związku z czym właściwości currencySymbol i currencyISOCode mogą mieć nieoczekiwane wartości. Przed sformatowaniem kwoty waluty dobrym rozwiązaniem jest sprawdzenie wartości właściwości currencySymbol i currencyISOCode.

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 po wywołaniu działanie konstruktora zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona 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

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

Tworzy ciąg reprezentujący kwotę w walucie sformatowaną zgodnie z bieżącymi właściwościami tego obiektu CurrencyFormatter, w szczególności zgodnie z ustawieniami regionalnymi, symbolem waluty i kodem ISO waluty.

Domyślnie ta metoda wykorzystuje właściwość currencyISOCode w celu określenia symbolu waluty oraz innych ustawień wykorzystanych podczas formatowania.

W wielu krajach i regionach używane są te same symbole dla różnych walut. Na przykład: w Stanach Zjednoczonych, Australii, Nowej Zelandii, Kanadzie i Meksyku używany jest znak dolara ($) dla wartości lokalnych walut. Jeśli waluta formatowania różni się od lokalnej waluty, wówczas najlepszym rozwiązaniem jest użycie kodu ISO jako ciągu znaków waluty. Za pomocą metody formattingWithCurrencySymbolIsSafe() można sprawdzić, czy kod ISO waluty przeznaczonej do sformatowania jest zgodny z właściwością currencyISOCode formatera.

Ta metoda może formatować liczby bardzo małe i bardzo duże. Jednak liczba cyfr znaczących jest ograniczona do precyzji, jaką zapewnia typ danych Number.

Parametry

Powiązane elementy interfejsu API

 
         var cf:CurrencyFormatter = new CurrencyFormatter("fr-CA");  
         
         trace(cf.actualLocaleIDName);               // "fr-CA"  
         trace(cf.currencyISOCode);                // "CAD"
         trace(cf.currencySymbol);                // "$"
         
         trace(cf.format(1254.56));                // "1 254,56 CAD"
         trace(cf.format(1254.56, true));            // "1 254,56 $"
         

 
         var cf:CurrencyFormatter = new CurrencyFormatter(LocaleID.DEFAULT);  
         
         if (cf.formattingWithCurrencySymbolIsSafe("CAD")) {
           trace(cf.actualLocaleIDName);     // "fr-CA French (Canada)"
           trace(cf.format(1254.56, false)); // "1 254,56 $"
         }
         else {
           trace(cf.actualLocaleIDName);     // "en-US English (USA)"
           cf.setCurrency("CAD", "C$")
           trace(cf.format(1254.56, true));  // "C$ 1,254.56"
         }
         

Określa, czy aktualnie ustawiony symbol waluty może być używany w przypadku formatowania kwot w walucie.

W wielu regionach i krajach używane są te same symbole walut. Taka metoda postępowania może zapobiegać stosowaniu niejednoznacznych symboli walut, albo symbolu waluty lub kodu ISO, który jest inny niż oczekiwany z powodu użycia alternatywnych ustawień narodowych.

Przykładem zastosowania tej metody jest konieczność określenia, czy wymagane jest wyświetlenie lokalnego symbolu waluty (jeśli kwota zostanie sformatowana w domyślnej walucie użytkownika), czy też bardziej dokładnego ciągu znaków kodu ISO (jeśli kwota zostanie sformatowana w walucie innej niż domyślna użytkownika).

Ta metoda porównuje parametr requestedISOCode z bieżącą właściwością currencyISOCode i zwraca true, jeśli ciągi znaków są równe, oraz false, jeśli nie są równe. Jeśli ciągi znaków są równe, wówczas użycie metody format() z parametrem withCurrencySymbol ustawionym na true spowoduje uzyskanie sformatowanego ciągu znaków wartości waluty z unikalnym symbolem waluty dla ustawień narodowych. Jeśli ta metoda zwróci wartość false, wówczas użycie metody format() z parametrem withCurrencySymbol ustawionym na true może spowodować użycie niejednoznacznego lub niepoprawnego symbolu waluty.

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, a wynikiem analizy jest kwota w walucie oraz symbol waluty.

Algorytm analizy wykorzystuje wartość właściwości decimalSeparator w celu określenia części całkowitej i ułamkowej liczby. Wykorzystuje wartości właściwości negativeCurrencyFormat i positiveCurrencyFormat w celu określenia lokalizacji symbolu waluty lub ciągu znaków waluty względem kwoty waluty. W przypadku kwot ujemnych wartość właściwości negativeCurrencyFormat określa umiejscowienie symbolu ujemnego oraz to, czy używane są nawiasy.

Jeśli kolejność symbolu waluty, znaku minusa oraz liczby w wejściowym ciągu znaków nie jest zgodna ze wzorcem określonym przez właściwości negativeCurrencyFormat i positiveCurrencyFormat, wówczas:

1. Właściwość value zwracanego obiektu CurrencyParseResult zostanie ustawiona na NaN.
2. Właściwość currencyString zwracanego obiektu CurrencyParseResult zostanie ustawiona na null.
3. Właściwość lastOperationStatus zostanie ustawiona w taki sposób, aby wskazywała, że analizowanie nie powiodło się.

Wejściowy ciąg znaków może zawierać znaki spacji, które będą ignorowane podczas analizowania.

Analizowanie może zakończyć się pomyślnie, nawet w przypadku braku symbolu waluty. Nie jest wykonywane sprawdzanie poprawności tej części ciągu znaków, która odpowiada symboli waluty. Jeśli nie ma symbolu ani ciągu znaków waluty, wówczas dla właściwości currencyString w zwracanym obiekcie CurrencyParseResult zostanie ustawiony pusty ciąg znaków.

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

Ustawia właściwości currencyISOCode i currencySymbol obiektu CurrencyFormatter.

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ści currencyISOCode i currencySymbol nie zostaną zmodyfikowane, a właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Parametry

Powiązane elementy interfejsu API

W przykładzie użyto następujących ustawień narodowych:

• domyślne ustawienia narodowe systemu operacyjnego na potrzeby formatowania walut (LocaleID.DEFAULT);
• japońskie (Japonia);
• angielskie (USA);
• francuskie (Francja).

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

1. Tworzy obiekt CurrencyFormatter.
2. Za pomocą metody formattingWithCurrencySymbolIsSafe() sprawdza, czy domyślną walutą dla tych ustawień narodowych jest euro ("EUR"), a jeśli tak, formatuje ciąg znaków, korzystając z symbolu tej waluty. W przeciwnym razie formatuje ciąg znaków, korzystając z kodu ISO waluty.

  
package {
    import flash.display.Sprite;
    import flash.globalization.CurrencyFormatter;
    import flash.globalization.LocaleID;
    
    public class CurrencyFormatterExample1 extends Sprite
    {
        public function CurrencyFormatterExample1():void
        {
            var cf:CurrencyFormatter;
            var amountWithSymbol:String;
            var amountWithISOCode:String
            
            var localeNames:Array = [LocaleID.DEFAULT, "ja-JP", "en-US", "fr-FR"];
            
            for each (var localeName:String in localeNames) 
            {
                cf = new CurrencyFormatter(localeName);
                
                trace('\n' + "LocaleID requested=" + cf.requestedLocaleIDName 
                    + "; actual=" + cf.actualLocaleIDName);
                
                trace("Last Operation Status: " + cf.lastOperationStatus );
                
                trace("Currency ISO Code: " + cf.currencyISOCode);
                
                if (cf.formattingWithCurrencySymbolIsSafe("EUR")) 
                {
                    amountWithSymbol = cf.format(123456789.19, true);
                    trace("Format using Symbol: "+ amountWithSymbol);
                }
                else 
                {
                    amountWithISOCode = cf.format(123456789.19); 
                    trace("Format using ISO Code: " + amountWithISOCode);
                }
            }
        }
    }
}

Przykładowy kod wykonuje następujące czynności:

1. Tworzy obiekt CurrencyFormatter dla angielskich (USA) ustawień narodowych.
2. Analizuje wejściowy ciąg znaków za pomocą metody parse().
3. Wyświetla kwotę i ciąg znaków waluty z wynikowego obiektu CurrencyParseResult.

 
package {
      import flash.display.Sprite;
      import flash.globalization.CurrencyFormatter;
      import flash.globalization.CurrencyParseResult;
      import flash.globalization.LastOperationStatus;
      import flash.globalization.LocaleID;

      public class CurrencyFormatterParseExample extends Sprite
      {
            public function CurrencyFormatterParseExample()
            {
                var cf:CurrencyFormatter = new CurrencyFormatter( "en_US" );
                
                trace("LocaleID requested=" + cf.requestedLocaleIDName 
                    + "; actual=" + cf.actualLocaleIDName);
                trace("Last Operation Status: " + cf.lastOperationStatus );

                var inputString:String = "Dollar 123,567,89,0.254";
                
                var result:CurrencyParseResult = cf.parse(inputString);
                
                if (cf.lastOperationStatus == LastOperationStatus.NO_ERROR ) {
                    trace("Amount value: " + result.value); 
                    trace("Currency string: " + result.currencyString); 
                }
            }
      }
}