NumberFormatter  - AS3

Il nome dell'ID di impostazioni internazionali effettivamente utilizzato da questo oggetto NumberFormatter.

Esistono tre possibilità per il nome del valore, a seconda del sistema operativo e del valore del parametro requestedLocaleIDName passato alla funzione di costruzione Collator().

1. Se le impostazioni internazionali richieste non corrispondevano al valore LocaleID.DEFAULT e il sistema operativo fornisce il supporto per tali impostazioni internazionali, il nome restituito corrisponde alla proprietà requestedLocaleIDName.
2. Se è stato utilizzato LocaleID.DEFAULT come valore del parametro requestedLocaleIDName passato alla funzione di costruzione, viene utilizzato il nome delle impostazioni internazionali correnti specificato dal sistema operativo dell'utente. Il valore LocaleID.DEFAULT mantiene l'impostazione personalizzata dell'utente nel sistema operativo. Se passate un valore esplicito come parametro requestedLocaleIDName, non viene necessariamente restituito lo stesso risultato fornito da LocaleID.DEFAULT, anche se i nomi dei due ID di impostazioni internazionali sono gli stessi. L'utente potrebbe avere personalizzato le impostazioni internazionali del proprio computer e la richiesta di un nome esplicito dell'ID di impostazioni internazionali, anziché l'utilizzo di LocaleID.DEFAULT può impedire all'applicazione di rilevare tali impostazioni personalizzate.
3. Se il sistema operativo non supporta il parametro requestedLocaleIDName specificato nella funzione di costruzione, viene fornito un nome dell'ID di impostazioni internazionali di riserva.

Elementi API correlati

Il carattere separatore dei decimali utilizzato per formattare o analizzare i numeri che includono una parte decimale.

Questa proprietà viene impostata inizialmente in base alle impostazioni internazionali selezionate durante la costruzione dell'oggetto formatter.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è dependent on the locale and operating system..

Elementi API correlati

Definisce il gruppo di caratteri cifra utilizzato per la formattazione dei numeri.

Lingue e aree diverse utilizzano set di caratteri diversi per rappresentare le cifre da 0 a 9. Questa proprietà definisce il set di cifre da utilizzare.

Il valore di questa proprietà rappresenta il valore Unicode per la cifra zero di un set di cifre decimali. I valori validi per questa proprietà sono definiti nella classe NationalDigitsType.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è dependent on the locale and operating system..

Elementi API correlati

Il numero massimo di cifre che possono apparire dopo il separatore dei decimali.

I numeri vengono arrotondati al numero di cifre specificato da questa proprietà. Lo schema di arrotondamento varia a seconda del sistema operativo dell'utente.

Quando la proprietà trailingZeros è impostata su true, le parti frazionarie del numero (dopo la virgola decimale) vengono completate con zero finali finché la lunghezza non corrisponde al valore della proprietà fractionalDigits.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è 0.

Elementi API correlati

Descrive la posizione dei separatori di raggruppamento all'interno della stringa numerica formattata.

Quando la proprietà useGrouping è impostata su true, la proprietà groupingPattern viene utilizzata per definire la posizione e lo schema utilizzati per il separatore di raggruppamento.

Lo schema di raggruppamento viene definito sotto forma di stringa contenente numeri separati da punti e virgola e facoltativamente terminata con un asterisco. Ad esempio: "3;2;*". Ogni numero nella stringa rappresenta il numero di cifre in un gruppo. Il separatore di raggruppamento viene inserito prima di ogni gruppo di cifre. Un asterisco alla fine della stringa indica che i gruppi contenenti tale numero di cifre dovranno essere ripetuti nel resto della stringa formattata. Se non è presente un asterisco, nel resto della stringa formattata non vi sono gruppi o separatori aggiuntivi.

Il primo numero contenuto nella stringa corrisponde al primo gruppo di cifre a sinistra del separatore dei decimali. I numeri successivi definiscono il numero di cifre nei successivi gruppi a sinistra. La stringa "3;2;*" indica pertanto che viene inserito un separatore di raggruppamento dopo il primo gruppo di 3 cifre, seguito da gruppi di 2 cifre. Ad esempio: 98,76,54,321

Nella seguente tabella sono illustrati esempi di formattazione del numero 123456789.12 con vari schemi di raggruppamento. Il separatore di raggruppamento è una virgola e il separatore dei decimali è un punto.

Potete definire solo un numero limitato di dimensioni di raggruppamento. In alcuni sistemi operativi, gli schemi di raggruppamento possono contenere solo due numeri e un asterisco. Altri sistemi operativi possono supportare fino a quattro numeri e un asterisco. Per gli schemi senza asterisco, alcuni sistemi operativi supportano un solo numero, mentre altri supportano fino a tre numeri. Se il numero massimo di elementi dello schema di raggruppamento viene superato, gli elementi aggiuntivi vengono ignorati e la proprietà lastOperationStatus viene impostata come descritto di seguito.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Elementi API correlati

Il carattere o la stringa utilizzata come separatore di raggruppamento.

Il valore di questa proprietà viene utilizzato come separatore di raggruppamento durante la formattazione dei numeri, se la proprietà useGrouping è impostata su true. Questa proprietà viene impostata inizialmente in base alle impostazioni internazionali selezionate durante la costruzione dell'oggetto formatter.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è dependent on the locale and operating system..

Elementi API correlati

Lo stato della precedente operazione eseguita da questo oggetto NumberFormatter. La proprietà lastOperationStatus viene impostata ogni volta che chiamate una funzione di costruzione o un metodo di questa classe oppure impostate un'altra proprietà. Per i valori possibili, fate riferimento alla descrizione dei singoli metodi.

Elementi API correlati

Specifica se viene incluso uno zero iniziale in un numero formattato quando non sono presenti cifre intere a sinistra del separatore dei decimali.

Quando questa proprietà è impostata su true a sinistra del separatore dei decimali viene incluso uno zero iniziale durante la formattazione di valori numeri compresi tra -1.0 e 1.0. Quando questa proprietà è impostata su false, non viene incluso uno zero iniziale.

Se il numero è, ad esempio, 0.321 e la proprietà è impostata su true, nella stringa formattata viene incluso lo zero iniziale. Se la proprietà è impostata su false, lo zero iniziale non viene incluso. In tal caso la stringa contiene solo il separatore dei decimali seguito dalle cifre decimali, ad esempio .321.

Nella seguente tabella sono riportati esempi di formattazione dei numeri in base ai valori di questa proprietà e alle proprietà correlate fractionalDigits e trailingZeros.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è dependent on the locale and operating system..

Elementi API correlati

Un valore numerico che indica uno schema di formattazione per i numeri negativi. Questo schema definisce la posizione del simbolo negativo o delle parentesi rispetto alla parte numerica del numero formattato.

Nella seguente tabella sono riepilogati i possibili formati per i numeri negativi. Quando viene formattato un numero negativo, il segno meno viene sostituito con il valore della proprietà negativeSymbol e il carattere "n" viene sostituito con il valore numerico formattato.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è dependent on the locale and operating system..

Elementi API correlati

Il simbolo negativo da utilizzare per la formattazione dei valori negativi.

Questo simbolo viene utilizzato insieme al formato numerico negativo durante la formattazione di un numero minore di zero. Non viene usato nei formati numerici negativi che non includono un segno negativo (ad esempio, quando i numeri negativi sono racchiusi tra parentesi).

Questa proprietà viene impostata su un valore predefinito per le impostazioni internazionali effettive al momento della costruzione di questo formatter. Può essere impostata con un valore che consenta di ignorare l'impostazione predefinita.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Elementi API correlati

Il nome dell'ID di impostazioni internazionali richiesto che è stato passato alla funzione di costruzione di questo oggetto NumberFormatter.

Se è stato utilizzato il valore LocaleID.DEFAULT, il nome restituito è "i-default". Quando vengono applicate impostazioni internazionali di riserva, le impostazioni internazionali effettivamente utilizzate possono essere diverse da quelle richieste. Il nome delle impostazioni internazionali effettive può essere recuperato utilizzando la proprietà actualLocaleIDName.

Elementi API correlati

Specifica se in un numero formattato vengono inclusi zero finali.

Quando questa proprietà è impostata su true, nella parte frazionaria del numero formattato vengono inclusi zero finali fino al limite specificato dalla proprietà fractionalDigits. Quando questa proprietà è impostata su false, non vengono visualizzati zero finali.

Se, ad esempio, il valore numerico è 123.4, se questa proprietà è impostata su true e la proprietà fractionalDigits è impostata su 3, la stringa formattata include zero finali, ad esempio 123.400. Se questa proprietà è false, non vengono inclusi zero finali e nella stringa viene visualizzato solo il separatore dei decimali seguito dalle cifre decimali diverse da zero, ad esempio 123.4.

Nella seguente tabella sono riportati esempi di formattazione dei valori numerici in base ai valori di questa proprietà e alle proprietà correlate fractionalDigits e leadingZero.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è dependent on the locale and operating system..

Elementi API correlati

Consente di utilizzare il separatore di raggruppamento per la formattazione dei numeri.

Quando la proprietà useGrouping è impostata su true, le cifre vengono raggruppate e delimitate dal carattere utilizzato come separatore di raggruppamento. Ad esempio: 123,456,789.22

Quando la proprietà useGrouping è impostata su false, le cifre non vengono raggruppato né separate. Ad esempio: 123456789.22

Il simbolo da utilizzare come separatore di raggruppamento è definito dalla proprietà groupingSeparator. Il numero di cifre tra i separatori di raggruppamento è definito dalla proprietà groupingPattern.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Elementi API correlati

Costruisce un nuovo oggetto NumberFormatter per formattare i numeri in base alle convenzioni di un determinato contesto di impostazioni internazionali.

Questa funzione di costruzione determina se il sistema operativo corrente supporta il nome dell'ID di impostazioni internazionali richiesto. Se non è supportato, vengono utilizzate delle impostazioni internazionali di riserva. Se vengono utilizzate impostazioni internazionali di riserva, la proprietà lastOperationStatus indica il tipo di riserva e la proprietà actualLocaleIDName contiene il nome dell'ID di impostazioni locali di riserva.

Per applicare la formattazione in base alle preferenze del sistema operativo corrente dell'utente, passate alla funzione di costruzione il valore LocaleID.DEFAULT nel parametro requestedLocaleIDName.

Quando la funzione di costruzione viene completata correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Quando il nome dell'ID di impostazioni internazionali richiesto non è disponibile, lastOperationStatus è impostata su uno dei valori seguenti:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

Se questa classe non è supportata nel sistema operativo corrente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.UNSUPPORTED_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Per informazioni dettagliate sugli avvisi sopra indicati e altri possibili valori della proprietà lastOperationStatus, fate riferimento alle descrizioni disponibili nella classe LastOperationStatus.

Elementi API correlati

Formatta un valore int. Questa funzione equivale al metodo formatNumber(), ma accetta un valore int. Se il valore passato è troppo grande o troppo piccolo, ad esempio maggiore di 1.72e308 o minore di 1.72e-308, questa funzione restituisce 0.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

Elementi API correlati

Formatta un valore Number.

Questa funzione formatta il numero in base ai valori delle proprietà del formatter. Se le proprietà non vengono modificate dopo la creazione dell'oggetto numberFormatter, i numeri vengono formattati in base alle convenzioni specifiche delle impostazioni internazionali fornite dal sistema operativo per il contesto di impostazioni internazionali identificato da actualLocaleIDName. Per personalizzare il formato, potete modificare le proprietà in modo da controllare gli aspetti specifici della formattazione di un numero.

I numeri molto grandi o molto piccoli possono essere formattati con questa funzione. Il numero di cifre significative è tuttavia limitato dalla precisione fornita dall'oggetto Number. La notazione scientifica non è supportata.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

Elementi API correlati

Formatta un valore uint. Questa funzione equivale al metodo formatNumber(), ma accetta un valore uint. Se il valore passato è troppo grande, ad esempio maggiore di 1.72e308, questa funzione restituisce 0.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

Elementi API correlati

Elenca tutti i nomi degli ID di impostazioni internazionali supportati da questa classe.

Se questa classe non è supportata dal sistema operativo corrente, il metodo restituisce un valore null.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Analizza una stringa e restituisce un oggetto NumberParseResult contenente gli elementi analizzati.

L'oggetto NumberParseResult contiene il valore del primo numero individuato nella stringa di input, la posizione di indice iniziale per il numero all'interno della stringa e la posizione di indice del primo carattere dopo il numero nella stringa.

Se la stringa non contiene un numero, la proprietà value di NumberParseResult viene impostata su NaN e le proprietà startIndex e endIndex vengono impostate sul valore esadecimale 0x7fffffff.

Questa funzione utilizza il valore della proprietà decimalSeparator per determinare la parte del numero che contiene cifre frazionarie, la proprietà groupingSeparator per determinare quali caratteri sono consentiti nelle cifre di un numero e la proprietà negativeNumberFormat per controllare come vengono rappresentati i valori negativi.

Nella seguente tabelle viene identificato il risultato delle stringhe analizzate in base ai diversi valori di NegativeNumberFormat:

Tra il numero e il segno meno o la parentesi è consentito un solo spazio vuoto.

Le altre proprietà vengono ignorate quando si determina un numero valido In particolare, viene ignorato il valore della proprietà digitsType e le cifre possono appartenere a qualsiasi set di cifre enumerate nella classe NationalDigitsType. Il valori delle proprietà groupingPattern e useGrouping non influiscono sull'analisi del numero.

Se all'interno della stringa i numeri sono preceduti o seguiti da un segno più "+", questo segno viene considerato come un carattere che non fa parte del numero.

Questa funzione non analizza le stringhe che contengono numeri scritti con la notazione scientifica (ad es. 1.23e40).

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

Elementi API correlati

 
         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"
         

Analizza una stringa contenente solo cifre, e facoltativamente caratteri spazio, e restituisce un valore numerico. Se la stringa non inizia con un numero o contiene caratteri diversi da uno spazio vuoto che non fanno parte del numero, questo metodo restituisce NaN. Gli spazi vuoti prima o dopo le cifre numeriche vengono ignorati. Uno spazio vuoto è un carattere con una proprietà Space Separator (Zs) nella specifica Unicode Character Database (http://www.unicode.org/ucd/).

Se la cifra numerica è preceduta o seguita da un segno più '+', viene trattata come un carattere diverso dallo spazio vuoto. Il valore restituito è NaN.

Per ulteriori informazioni sull'analisi dei numeri che costituiscono un numero valido, fate riferimento alla descrizione della funzione parse.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

Elementi API correlati

In questo esempio vengono utilizzate le seguenti impostazioni internazionali: impostazioni internazionali predefinite del sistema operativo per la formattazione numerica, giapponese (Giappone), inglese (Stati Uniti) e francese (Francia). Nell'esempio viene utilizzato il membro statico LocaleID.DEFAULT per richiedere le impostazioni internazionali predefinite del sistema operativo.

I risultati di questo esempio potrebbero differire a seconda del sistema operativo in uso e delle preferenze dell'utente.

Nell'esempio vengono effettuate le seguenti operazioni per ogni contesto di impostazioni internazionali incluso nell'elenco:

1. Crea un oggetto NumberFormatter.
2. Formatta lo stesso valore come numero (Number), come intero (Int) e come intero senza segno (UInt), quindi visualizza il risultato.

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

I risultati di questo esempio potrebbero differire a seconda del sistema operativo in uso e delle preferenze dell'utente.

L'esempio esegue le seguenti operazioni:

1. Crea un oggetto NumberFormatter.
2. Chiama il metodo NumberFormatter.parse() per analizzare la stringa e restituire un oggetto NumberParseResult.
3. Chiama il metodo NumberFormatter.parseNumber() per analizzare la stringa e restituire un oggetto 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);
                }
            }
      }
}