NumberFormatter  - AS3

Namnet på det faktiska språk-ID som används av det här NumberFormatter-objektet.

Det finns tre möjliga värden för namnet, beroende på operativsystemet och värdet på den requestedLocaleIDName-parameter som skickas till Collator()-konstruktorn.

1. Om det begärda språket inte var LocaleID.DEFAULT, och operativsystemet har stöd för det begärda språket, är det namn som returneras samma som egenskapen requestedLocaleIDName.
2. Om LocaleID.DEFAULT användes som värdet för parametern requestedLocaleIDName till konstruktorn, används det namn för det aktuella språket som specificeras av användarens operativsystem. Värdet LocaleID.DEFAULT bevarar användarens anpassade inställningar i operativsystemet. Om du skickar ett uttryckligt värde som requestedLocaleIDName-parameter ger det inte nödvändigtvis samma resultat som när du använder LocaleID.DEFAULT, även om de båda språknamnen är samma. Användaren kan ha anpassat språkinställningarna på datorn, och om han/hon begär ett uttryckligt språk-ID i stället för att använda LocaleID.DEFAULT hämtar ditt program inte dessa anpassade inställningar.
3. Om systemet saknar stöd för det requestedLocaleIDName som anges i konstruktorn används ett reservspråk-ID i stället.

Relaterade API-element

Den decimalavgränsare som används för att formatera eller tolka tal med decimaler.

Den här egenskapen ställs först in baserat på det språk som är valt när formateringsobjektet skapas.

När den här egenskapen tilldelas ett värde, och det inte visas några varningar eller fel, ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Standardvärdet är dependent on the locale and operating system..

Relaterade API-element

Definierar den sifferuppsättning som ska användas för att formatera tal.

Olika språk och regioner använder olika teckenuppsättningar för att representera siffrorna 0 till 9. Den här egenskapen definierar den sifferuppsättning som ska användas

Värdet på den här egenskapen representerar Unicode-värdet för siffran noll i en decimalsifferuppsättning. Giltiga värden för den här egenskapen definieras i klassen NationalDigitsType.

När den här egenskapen tilldelas ett värde, och det inte visas några varningar eller fel, ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Standardvärdet är dependent on the locale and operating system..

Relaterade API-element

Det största antal siffror som kan visas efter decimaltecknet.

Talen avrundas till det antal siffror som anges av den här egenskapen. Avrundningsschemat varierar beroende på användarens operativsystem.

När egenskapen trailingZeros är true fylls talets bråkdel (efter decimaltecknet) ut med nollor tills längden matchar värdet för den här fractionalDigits-egenskapen.

När den här egenskapen tilldelas ett värde, och det inte visas några varningar eller fel, ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Standardvärdet är 0.

Relaterade API-element

Beskriver placeringen för grupperingsavgränsare i den formaterade nummersträngen.

När egenskapen useGrouping är true används egenskapen groupingPattern för att definiera den placering och det mönster som används för grupperingsavgränsaren.

Grupperingsmönstret definieras som en sträng med tal, som avgränsas med semikolon och som kan avslutas med en asterisk. Till exempel: "3;2;*". Varje tal i strängen representerar antalet siffror i en grupp. Grupperingsavgränsaren placeras före varje siffergrupp. En asterisk i slutet av strängen anger att grupper med det antalet siffror ska upprepas i resten av den formaterade strängen. Om det inte finns någon asterisk finns inga ytterligare grupper eller avgränsare för resten av den formaterade strängen.

Det första talet i strängen motsvarar den första gruppen med siffror till vänster om decimaltecknet. Efterföljande tal definierar antalet siffror i efterföljande grupper till vänster. Strängen "3;2;*" anger alltså att en grupperingsavgränsare placeras efter den första gruppen med tre siffror, följt av grupper med två siffror. Till exempel: 98,76,54,321

Följande tabell innehåller exempel på hur talet 123456789.12 kan formateras med olika grupperingsmönster. Grupperingsavgränsaren är ett komma och decimaltecknet är en punkt.

Du kan bara definiera ett begränsat antal grupperingsstorlekar. På vissa operativsystem kan grupperingsmönster bara innehålla två tal plus en asterisk. Andra operativsystem kan ha stöd för fyra tal och en asterisk. För mönster utan någon asterisk har vissa operativsystem bara stöd för ett tal, medan andra har stöd för upp till tre. Om det största tillåtna antalet element för grupperingsmönstret överskrids ignoreras ytterligare element och egenskapen lastOperationStatus ställs in enligt nedanstående.

När den här egenskapen tilldelas ett värde, och det inte visas några varningar eller fel, ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Relaterade API-element

Det tecken eller den sträng som används för grupperingsavgränsaren.

Värdet på den här egenskapen används som grupperingsavgränsare vid formatering av tal när egenskapen useGrouping är inställd på true. Den här egenskapen ställs först in baserat på det språk som är valt när formateringsobjektet skapas.

När den här egenskapen tilldelas ett värde, och det inte visas några varningar eller fel, ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Standardvärdet är dependent on the locale and operating system..

Relaterade API-element

Status för den tidigare åtgärden som detta NumberFormatter-objekt utförde. Egenskapen lastOperationStatus anges när konstruktorn eller en metod för den här klassen anropas eller när en annan egenskap anges. Beskrivningarna av de olika metoderna innehåller information om möjliga värden.

Relaterade API-element

Anger om en inledande nolla ska inkluderas i ett formaterat tal när det inte finns några heltalssiffror till vänster om decimaltecknet.

När den här egenskapen är true inkluderas en inledande nolla till vänster om decimaltecknet vid formatering av numeriska värden mellan -1,0 och 1,0. När egenskapen är false inkluderas ingen inledande nolla.

Om talet till exempel är 0,321, och den här egenskapen är true, inkluderas den inledande nollan i den formaterade strängen. Om egenskapen är false inkluderas ingen inledande nolla. I så fall innehåller strängen bara decimaltecknet följt av decimalerna, som i .321.

Följande tabell innehåller exempel på hur tal formateras baserat på värdena för den här egenskapen och de relaterade egenskaperna fractionalDigits och trailingZeros.

När den här egenskapen tilldelas ett värde, och det inte visas några varningar eller fel, ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Standardvärdet är dependent on the locale and operating system..

Relaterade API-element

Ett numeriskt värde som anger ett formateringsmönster för negativa tal. Det här mönstret definierar placeringen av den negativa symbolen eller parentesen i förhållande till den numeriska delen av det formaterade talet.

Följande tabell sammanfattar möjliga format för negativa tal. När ett negativt tal formateras ersätts minustecknet i formatet med värdet för egenskapen negativeSymbol och tecknet 'n' ersätts med det formaterade numeriska värdet.

När den här egenskapen tilldelas ett värde, och det inte visas några varningar eller fel, ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Standardvärdet är dependent on the locale and operating system..

Relaterade API-element

Den negativa symbol som ska användas vid formatering av negativa värden.

Den här symbolen används med negativa tal vid formatering av tal som är mindre än noll. Det används inte i format för negativa tal som inte innehåller ett negativt tecken (t.ex. när negativa tal står inom parentes).

Den här egenskapen ställs in på ett standardvärde för det faktiska språk som användes när den här formateraren skapades. Du kan ange ett värde som medför att standardinställningen ignoreras.

När den här egenskapen tilldelas ett värde, och det inte visas några varningar eller fel, ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Relaterade API-element

Namnet på det begärda språk-ID som skickades till konstruktorn för det här NumberFormatter-objektet.

Om värdet LocaleID.DEFAULT användes returneras namnet "i-default". Det språk som faktiskt används kan skilja sig från det begärda språket när ett reservspråk används. Namnet på det faktiska språket kan hämtas med egenskapen actualLocaleIDName.

Relaterade API-element

Anger om efterföljande nollor ska inkluderas i ett formaterat tal.

När den här egenskapen är true inkluderas efterföljande nollor i det formaterade talets bråkdel, upp till den gräns som anges av egenskapen fractionalDigits. När den här egenskapen är false visas inga efterföljande nollor.

Om det numeriska värdet till exempel är 123.4, och den här egenskapen är true och egenskapen fractionalDigits är 3, innehåller den formaterade strängen efterföljande nollor, som i 123.400. Om den här egenskapen är false inkluderas inga efterföljande nollor och strängen visar bara decimaltecknet följt av de decimaler som inte är nollor, som i 123.4.

Följande tabell innehåller exempel på hur numeriska värden formateras baserat på värdena för den här egenskapen och de relaterade egenskaperna fractionalDigits och leadingZero.

När den här egenskapen tilldelas ett värde, och det inte visas några varningar eller fel, ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Standardvärdet är dependent on the locale and operating system..

Relaterade API-element

Medger användning av grupperingsavgränsare vid formatering av tal.

När egenskapen useGrouping är true grupperas siffror och avgränsas med tecknet för grupperingsavgränsaren. Till exempel: 123,456,789.22

När egenskapen useGrouping är false varken grupperas eller avgränsas siffror. Till exempel: 123456789.22

Den symbol som ska användas som grupperingsavgränsare definieras av egenskapen groupingSeparator. Antalet siffror mellan grupperingsavgränsare definieras av egenskapen groupingPattern.

När den här egenskapen tilldelas ett värde, och det inte visas några varningar eller fel, ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Relaterade API-element

Skapar ett nytt NumberFormatter-objekt för att formatera tal i enlighet med reglerna för ett visst språk.

Den här konstruktorn avgör om det aktuella operativsystemet har stöd för det begärda språk-ID:t. Om det inte stöds används ett reservspråk i stället. Om ett reservspråk används visar egenskapen lastOperationStatus dess typ, och egenskapen actualLocaleIDName innehåller namnet på reservspråket.

Om formateringen ska ske baserat på användarens aktuella operativsysteminställningar skickar du värdet LocaleID.DEFAULT i parametern requestedLocaleIDName till konstruktorn.

När konstruktorn slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

När det begärda språk-ID:t inte är tillgängligt ställs lastOperationStatus in på något av följande:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

Om den här klassen inte stöds på det aktuella operativsystemet ställs egenskapen lastOperationStatus in på följande:

• LastOperationStatus.UNSUPPORTED_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Mer information om de varningsmeddelanden som visas ovan och andra möjliga värden för egenskapen lastOperationStatus finns i beskrivningarna för klassen LastOperationStatus.

Relaterade API-element

Formaterar ett int-värde. Den här funktionen motsvarar metoden formatNumber(), bortsett från att den använder ett int-värde. Om det värde som skickas är för stort eller för litet, exempelvis ett värde större än 1,72e308 eller mindre än 1,72e-308, returnerar den här funktionen 0.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Parametrar

Relaterade API-element

Formaterar ett nummervärde.

Den här funktionen formaterar talet baserat på formaterarens egenskapsvärden. Om egenskaperna inte ändras efter att numberFormatter-objektet skapas, formateras talen i enlighet med de språkspecifika konventionerna i operativsystemet för det språk som identifieras av actualLocaleIDName. Om du vill anpassa formatet kan du ändra egenskaperna för att styra särskilda delar av talformateringen.

Mycket stora och mycket små tal kan formateras med den här funktionen. Antalet värdesiffror är dock begränsade till den precision som anges i Number-objektet. Grundpotensform stöds inte.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Parametrar

Relaterade API-element

Formaterar ett uint-värde. Den här funktionen motsvarar metoden formatNumber(), bortsett från att den använder ett uint-värde. Om det värde som skickas är för stort, exempelvis ett värde större än 1,72e308, returnerar den här funktionen 0.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Parametrar

Relaterade API-element

Visar alla språk-ID:n som stöds i den här klassen.

Om den här klassen inte stöds på det aktuella operativsystemet returnerar metoden värdet null.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Tolkar en sträng och returnerar ett NumberParseResult-objekt med de tolkade elementen.

NumberParseResult-objektet innehåller värdet på det första tal som hittas i indatasträngen, startindexet för talet i strängen och indexet för det första tecknet efter talet i strängen.

Om strängen inte innehåller något tal ställs värdeegenskapen för NumberParseResult in på NaN, och egenskaperna startIndex och endIndex ställs in på det hexadecimala värdet 0x7fffffff.

Den här funktionen använder värdet på egenskapen decimalSeparator för att fastställa den del av talet som innehåller bråkdelen, egenskapen groupingSeparator för att fastställa vilka tecken som tillåts som ett tals siffror och egenskapen negativeNumberFormat för att styra hur negativa värden representeras.

Följande tabell visar resultatet för strängar som tolkats för de olika NegativeNumberFormat-värdena:

Ett enda mellanslag tillåts mellan talet och minustecknet eller parentesen.

Andra egenskaper ignoreras när det giltiga talet fastställs. Närmare bestämt ignoreras värdet för egenskapen digitsType och siffrorna kan komma från alla sifferuppsättningar som räknas upp i klassen NationalDigitsType. Värdena på egenskaperna groupingPattern och useGrouping påverkar inte tolkningen av talet.

Om tal i en sträng föregås eller följs av ett plustecken (+) behandlas plustecknet som ett tecken som inte ingår i talet.

Den här funktionen kan inte användas för att tolka strängar som innehåller tal i grundpotensformen (t.ex. 1.23e40).

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Parametrar

Relaterade API-element

 
         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"
         

Tolkar en sträng som bara innehåller siffror och valfria blankstegstecken och returnerar ett tal. Om strängen inte börjar på en siffra, eller innehåller andra tecken än mellanslag som inte ingår i talet, returnerar den här metoden NaN. Tomt utrymme före eller efter siffran ignoreras. Ett tomt utrymme/mellanslag är ett tecken som har egenskapen Space Separator (Zs) i Unicode-teckendatabasen (se http://www.unicode.org/ucd/).

Om siffran förgås eller följs av ett plustecken "+" hanteras det inte som ett blankstegstecken. Det returnerade värdet är NaN.

Beskrivningen av funktionen parse innehåller mer information om tolkning av tal och vad ett giltigt nummer är.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Parametrar

Relaterade API-element

I det här exemplet används följande språk: standardspråket på användarens operativsystem för talformatering, japanska (Japan), engelska (USA) och franska (Frankrike). Exemplet använder den statiska medlemmen LocaleID.DEFAULT för att begära standardspråket på användarens operativsystem.

Resultatet i det här exemplet kan skilja sig åt beroende på vilket operativsystem och vilka användarinställningar som används.

I exemplet utförs följande för varje språk i listan:

1. Skapar ett NumberFormatter-objekt.
2. Formaterar samma värde som ett tal, ett heltal och ett heltal utan teckenbit och visar resultatet.

 
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);
            }
        }
    }
}

Resultatet i det här exemplet kan skilja sig åt beroende på vilket operativsystem och vilka användarinställningar som används.

I det här exemplet utförs följande:

1. Skapar ett NumberFormatter-objekt.
2. Anropar metoden NumberFormatter.parse() för att tolka strängen och returnera ett NumberParseResult-objekt.
3. Anropar metoden NumberFormatter.parseNumber() för att tolka strängen och returnera ett Number-värde.

 
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);
                }
            }
      }
}