Pacchetto | flash.globalization |
Classe | public final class CurrencyFormatter |
Ereditarietà | CurrencyFormatter Object |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
La classe CurrencyFormatter utilizza i dati e la funzionalità forniti dal sistema operativo ed è progettata per formattare i valori di valuta in base alle convenzioni di un contesto di impostazioni internazionali e di un tipo di valuta specifici. La posizione del simbolo di valuta, del simbolo negativo, del separatore decimale, del separatore di raggruppamento, dello schema di raggruppamento, del separatore dei decimali e di altri elementi può variare in base alle impostazioni internazionali.
Se le impostazioni internazionali richieste sono supportate dal sistema operativo, le proprietà e il tipo di valuta vengono impostati in base alle convenzioni e ai valori predefiniti di tali impostazioni internazionali richieste. Se le impostazioni internazionali richieste non sono disponibili, le proprietà vengono definite in base alle impostazioni internazionali di sistema predefinite o di riserva, che possono essere recuperate tramite la proprietà actualLocaleIDName
.
In conseguenza dell'uso delle impostazioni dell'utente, degli schemi di formattazione forniti dal sistema operativo e delle impostazioni internazionali di riserva quando quelle richieste non sono supportate, i risultati della formattazione saranno diversi da utente a utente, anche se questi utilizzano lo stesso ID di impostazioni internazionali.
Proprietà | Definito da | ||
---|---|---|---|
actualLocaleIDName : String [sola lettura]
Il nome dell'ID di impostazioni internazionali effettivamente utilizzato da questo oggetto CurrencyFormatter. | CurrencyFormatter | ||
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
currencyISOCode : String [sola lettura]
Il codice di valuta ISO 4217 di tre lettere per le impostazioni internazionali effettivamente utilizzate. | CurrencyFormatter | ||
currencySymbol : String [sola lettura]
Il simbolo di valuta o la stringa corrispondente alle impostazioni internazionali effettivamente utilizzate. | CurrencyFormatter | ||
decimalSeparator : String
Il carattere separatore dei decimali utilizzato per formattare o analizzare gli importi in valuta che includono una parte decimale. | CurrencyFormatter | ||
digitsType : uint
Definisce il set di caratteri cifra utilizzato per la formattazione degli importi in valuta. | CurrencyFormatter | ||
fractionalDigits : int
Il numero massimo di cifre che possono apparire dopo il separatore dei decimali. | CurrencyFormatter | ||
groupingPattern : String
Descrive la posizione dei separatori di raggruppamento all'interno della stringa dell''importo in valuta formattata. | CurrencyFormatter | ||
groupingSeparator : String
Il carattere o la stringa utilizzata come separatore di raggruppamento. | CurrencyFormatter | ||
lastOperationStatus : String [sola lettura]
Lo stato dell'operazione più recente eseguita da questo oggetto CurrencyFormatter. | CurrencyFormatter | ||
leadingZero : Boolean
Specifica se viene incluso uno zero iniziale in un importo in valuta formattato quando non sono presenti cifre intere a sinistra del separatore dei decimali. | CurrencyFormatter | ||
negativeCurrencyFormat : uint
Un valore numerico che indica uno schema di formattazione per gli importi in valuta negativi. | CurrencyFormatter | ||
negativeSymbol : String
Il simbolo negativo utilizzato per la formattazione degli importi in valuta negativi. | CurrencyFormatter | ||
positiveCurrencyFormat : uint
Un valore numerico che indica uno schema di formattazione per gli importi in valuta positivi. | CurrencyFormatter | ||
requestedLocaleIDName : String [sola lettura]
Il nome dell'ID di impostazioni internazionali richiesto che è stato passato alla funzione di costruzione di questo oggetto CurrencyFormatter. | CurrencyFormatter | ||
trailingZeros : Boolean
Specifica se nell'importo in valuta formattato vengono inclusi zero finali. | CurrencyFormatter | ||
useGrouping : Boolean
Consente di utilizzare il separatore di raggruppamento per la formattazione degli importi in valuta. | CurrencyFormatter |
Metodo | Definito da | ||
---|---|---|---|
CurrencyFormatter(requestedLocaleIDName:String)
Costruisce un nuovo oggetto CurrencyFormatter per formattare i numeri che rappresentano gli importi in valuta in base alle convenzioni di un determinato contesto di impostazioni internazionali. | CurrencyFormatter | ||
Crea una stringa che rappresenta un importo in valuta formattato in base alle proprietà correnti di questo oggetto CurrencyFormatter, inclusi le impostazioni internazionali, il simbolo di valuta e il codice ISO della valuta. | CurrencyFormatter | ||
Determina se il simbolo di valuta attualmente specificato può essere utilizzato per la formattazione degli importi in valuta. | CurrencyFormatter | ||
[statico]
Elenca tutti i nomi degli ID di impostazioni internazionali supportati da questa classe. | CurrencyFormatter | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
Analizza una stringa ottenendo un iporto in valuta con simbolo di valuta. | CurrencyFormatter | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
Imposta le proprietà currencyISOCode e currencySymbol dell'oggetto CurrencyFormatter | CurrencyFormatter | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | ||
Restituisce il valore di base dell'oggetto specificato. | Object |
actualLocaleIDName | proprietà |
actualLocaleIDName:String
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Il nome dell'ID di impostazioni internazionali effettivamente utilizzato da questo oggetto CurrencyFormatter.
Esistono tre possibilità per il valore del nome, a seconda del sistema operativo e del valore del parametro requestedLocaleIDName
passato alla funzione di costruzione CurrencyFormatter()
.
- 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
. - Se è stato utilizzato
LocaleID.DEFAULT
come valore del parametrorequestedLocaleIDName
passato alla funzione di costruzione, viene utilizzato il nome delle impostazioni internazionali correnti specificato dal sistema operativo dell'utente. Il valoreLocaleID.DEFAULT
mantiene l'impostazione personalizzata dell'utente nel sistema operativo. Se passate un valore esplicito come parametrorequestedLocaleIDName
, non viene necessariamente restituito lo stesso risultato fornito daLocaleID.DEFAULT
, anche se i nomi dei due ID di impostazioni internazionali sono gli stessi. L'utente potrebbe avere personalizzato le impostazioni internazionali del computer e la richiesta di un nome esplicito dell'ID di impostazioni internazionali, anziché l'utilizzo diLocaleID.DEFAULT
, può impedire all'applicazione di rilevare tali impostazioni personalizzate. - 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.
Implementazione
public function get actualLocaleIDName():String
Elementi API correlati
currencyISOCode | proprietà |
currencyISOCode:String
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Il codice di valuta ISO 4217 di tre lettere per le impostazioni internazionali effettivamente utilizzate.
Questo codice viene utilizzato per determinare la stringa o il simbolo di valuta durante la formattazione degli importi in valuta tramite il metodo format()
con il parametro withCurrencySymbol
impostato su false
.
Questa proprietà viene inizializzata dalla funzione di costruzione in base alle impostazioni internazionali effettivamente utilizzate. Quando vengono utilizzate le impostazioni internazionali di riserva, questa proprietà riflette il codice di valuta preferito e predefinito di tali impostazioni internazionali di riserva.
Il valore predefinito è dependent on the actual locale and operating system.
Implementazione
public function get currencyISOCode():String
Elementi API correlati
currencySymbol | proprietà |
currencySymbol:String
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Il simbolo di valuta o la stringa corrispondente alle impostazioni internazionali effettivamente utilizzate.
Questa proprietà viene utilizzata come simbolo di valuta durante la formattazione degli importi in valuta tramite il metodo format()
con il parametro withCurrencySymbol
impostato su true
.
Questa proprietà viene inizializzata dalla funzione di costruzione in base alle impostazioni internazionali effettivamente utilizzate. Quando vengono utilizzate le impostazioni internazionali di riserva, questa proprietà riflette il simbolo di valuta preferito e predefinito di tali impostazioni internazionali di riserva.
Il valore predefinito è dependent on the actual locale and operating system.
Implementazione
public function get currencySymbol():String
Elementi API correlati
decimalSeparator | proprietà |
decimalSeparator:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Il carattere separatore dei decimali utilizzato per formattare o analizzare gli importi in valuta 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 actual locale and operating system.
Implementazione
public function get decimalSeparator():String
public function set decimalSeparator(value:String):void
Genera
TypeError — Se a questa proprietà è assegnato un valore null.
|
Elementi API correlati
digitsType | proprietà |
digitsType:uint
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Definisce il set di caratteri cifra utilizzato per la formattazione degli importi in valuta.
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 actual locale and operating system.
Implementazione
public function get digitsType():uint
public function set digitsType(value:uint):void
Genera
TypeError — Se a questa proprietà è assegnato un valore null.
|
Elementi API correlati
fractionalDigits | proprietà |
fractionalDigits:int
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
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.
Implementazione
public function get fractionalDigits():int
public function set fractionalDigits(value:int):void
Elementi API correlati
groupingPattern | proprietà |
groupingPattern:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Descrive la posizione dei separatori di raggruppamento all'interno della stringa dell''importo in valuta 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 dell'importo in valuta 123456789.12 con vari schemi di raggruppamento. Il separatore di raggruppamento è una virgola, il separatore dei decimali è un punto e il simbolo del dollaro ($) è il simbolo di valuta.
Schema di raggruppamento | Formato di esempio |
3;* | $123,456,789.12 |
3;2;* | $12,34,56,789.12 |
3 | $123456,789.12 |
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
.
Implementazione
public function get groupingPattern():String
public function set groupingPattern(value:String):void
Genera
TypeError — Se a questa proprietà è assegnato un valore null.
|
Elementi API correlati
groupingSeparator | proprietà |
groupingSeparator:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Il carattere o la stringa utilizzata come separatore di raggruppamento.
Il valore di questa proprietà viene utilizzato come separatore di raggruppamento durante la formattazione degli importi in valuta 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 actual locale and operating system.
Implementazione
public function get groupingSeparator():String
public function set groupingSeparator(value:String):void
Genera
TypeError — Se a questa proprietà è assegnato un valore null.
|
Elementi API correlati
lastOperationStatus | proprietà |
lastOperationStatus:String
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Lo stato dell'operazione più recente eseguita da questo oggetto CurrencyFormatter. 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.
Implementazione
public function get lastOperationStatus():String
Elementi API correlati
leadingZero | proprietà |
leadingZero:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Specifica se viene incluso uno zero iniziale in un importo in valuta 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 l'importo in valuta è, 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 degli importi in valuta in base ai valori di questa proprietà e alle proprietà correlate fractionalDigits
e trailingZeros
.
trailingZeros | leadingZero | fractionalDigits | 0.12 | 0 |
true | true | 3 | $0.120 | $0.000 |
false | true | 3 | $0.12 | $0 |
true | false | 3 | $.120 | $.000 |
false | false | 3 | $.12 | $0 |
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 actual locale and operating system.
Implementazione
public function get leadingZero():Boolean
public function set leadingZero(value:Boolean):void
Genera
TypeError — Se a questa proprietà è assegnato un valore null.
|
Elementi API correlati
negativeCurrencyFormat | proprietà |
negativeCurrencyFormat:uint
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Un valore numerico che indica uno schema di formattazione per gli importi in valuta negativi. Questo schema definisce la posizione del simbolo di valuta e del simbolo negativo o delle parentesi rispetto alla parte numerica dell'importo in valuta.
Il valore di questa proprietà deve essere una delle costanti definite nella tabella sottostante.
Nella tabella seguente sono riepilogati i possibili schemi di formattazione per gli importi in valuta negativi. Quando un importo in valuta viene formattato con il metodo format()
:
- il simbolo "¤" viene sostituito con il valore della proprietà
currencyISOCode
ocurrencySymbol
, a seconda del valore del parametrowithCurrencySymbol
passato al metodoformat()
; - il carattere "-" viene sostituito con il valore della proprietà
negativeNumberSymbol
; - Il carattere "n" viene sostituito con il valore dell'importo in valuta passato al metodo
format()
.
Tipo di formato di valuta negativo | Schema di formattazione |
0 | (¤n) |
1 | -¤n |
2 | ¤-n |
3 | ¤n- |
4 | (n¤) |
5 | -n¤ |
6 | n-¤ |
7 | n¤- |
8 | -n ¤ |
9 | -¤ n |
10 | n ¤- |
11 | ¤ n- |
12 | ¤ -n |
13 | n- ¤ |
14 | (¤ n) |
15 | (n ¤) |
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 actual locale and operating system.
Implementazione
public function get negativeCurrencyFormat():uint
public function set negativeCurrencyFormat(value:uint):void
Genera
ArgumentError — Se il valore assegnato non è compreso tra 0 e 15.
|
Elementi API correlati
negativeSymbol | proprietà |
negativeSymbol:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Il simbolo negativo utilizzato per la formattazione degli importi in valuta negativi.
Questo simbolo viene utilizzato insieme al formato di valuta negativo durante la formattazione di un importo in valuta minore di zero. Non viene usato nei formati di valuta negativi che non includono un segno negativo (ad esempio, quando gli importi in valuta negativi sono racchiusi tra parentesi).
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 actual locale and operating system.
Implementazione
public function get negativeSymbol():String
public function set negativeSymbol(value:String):void
Genera
TypeError — Se a questa proprietà è assegnato un valore null.
|
Elementi API correlati
positiveCurrencyFormat | proprietà |
positiveCurrencyFormat:uint
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Un valore numerico che indica uno schema di formattazione per gli importi in valuta positivi. Questo formato definisce la posizione del simbolo di valuta rispetto alla parte numerica dell'importo in valuta.
Il valore di questa proprietà deve essere una delle costanti definite nella tabella sottostante.
Nella tabella seguente sono riepilogati i possibili schemi di formattazione per gli importi in valuta positivi. Quando un importo in valuta viene formattato con il metodo format()
:
- il simbolo "¤" viene sostituito con il valore della proprietà
currencyISOCode
ocurrencySymbol
, a seconda del valore del parametrowithCurrencySymbol
passato al metodoformat()
; - Il carattere "n" viene sostituito con il valore dell'importo in valuta passato al metodo
format()
.
Tipo di formato di valuta positivo | Schema di formattazione |
0 | ¤n |
1 | n¤ |
2 | ¤ n |
3 | n ¤ |
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 actual locale and operating system.
Implementazione
public function get positiveCurrencyFormat():uint
public function set positiveCurrencyFormat(value:uint):void
Genera
ArgumentError — Se il valore assegnato non è compreso tra 0 e 3.
|
Elementi API correlati
requestedLocaleIDName | proprietà |
requestedLocaleIDName:String
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Il nome dell'ID di impostazioni internazionali richiesto che è stato passato alla funzione di costruzione di questo oggetto CurrencyFormatter.
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
.
Implementazione
public function get requestedLocaleIDName():String
Elementi API correlati
trailingZeros | proprietà |
trailingZeros:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Specifica se nell'importo in valuta 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, l'importo in valuta è 123.4, questa proprietà è impostata su true e la proprietà fractionalDigits
è impostata su 3, la stringa formattata includerà 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 degli importi in valuta in base ai valori di questa proprietà e alle proprietà correlate fractionalDigits
e leadingZero
.
trailingZeros | leadingZero | fractionalDigits | 0.12 | 0 |
true | true | 3 | $0.120 | $0.000 |
false | true | 3 | $0.12 | $0 |
true | false | 3 | $.120 | $.000 |
false | false | 3 | $.12 | $0 |
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 actual locale and operating system.
Implementazione
public function get trailingZeros():Boolean
public function set trailingZeros(value:Boolean):void
Genera
TypeError — Se a questa proprietà è assegnato un valore null.
|
Elementi API correlati
useGrouping | proprietà |
useGrouping:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Consente di utilizzare il separatore di raggruppamento per la formattazione degli importi in valuta.
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
Quando la proprietà useGrouping
è impostata su false
, le cifre non vengono raggruppato né separate. Ad esempio: $123456789
La proprietà groupingSeparator
definisce il simbolo da utilizzare come separatore di raggruppamento. La proprietà groupingPattern
definisce il numero di cifre tra i separatori di raggruppamento.
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
.
Implementazione
public function get useGrouping():Boolean
public function set useGrouping(value:Boolean):void
Elementi API correlati
CurrencyFormatter | () | Funzione di costruzione |
public function CurrencyFormatter(requestedLocaleIDName:String)
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Costruisce un nuovo oggetto CurrencyFormatter per formattare i numeri che rappresentano gli importi in valuta 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.
Alcune proprietà, come currencySymbol
e currencyISOCode
, vengono impostate automaticamente in base alle impostazioni internazionali.
NOTA: quando si utilizzano le impostazioni internazionali di riserva, le proprietà della valuta vengono impostate sui valori predefiniti, di conseguenza è possibile che alla proprietà currencySymbol
o currencyISOCode
vengano assegnati valori imprevisti. È pertanto opportuno esaminare i valori delle proprietà currencySymbol
e currencyISOCode
prima di formattare un importo in valuta.
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 chiamata e 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
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
.
requestedLocaleIDName:String — Il nome dell'ID di impostazioni internazionali preferite da utilizzare per determinare i formati di data e ora.
|
Genera
TypeError — Se il parametro requestedLocaleIDName è null .
|
Elementi API correlati
format | () | metodo |
public function format(value:Number, withCurrencySymbol:Boolean = false):String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Crea una stringa che rappresenta un importo in valuta formattato in base alle proprietà correnti di questo oggetto CurrencyFormatter, inclusi le impostazioni internazionali, il simbolo di valuta e il codice ISO della valuta.
Per impostazione predefinita, questo metodo utilizza la proprietà currencyISOCode
per determinare il simbolo di valuta e altre impostazioni utilizzate durante la formattazione.
In molti paesi e aree vengono utilizzati gli stessi simboli di valuta per diverse valute. Ad esempio, Stati Uniti, Australia, Nuova Zelanda, Canada e Messico utilizzano tutti lo stesso simbolo di dollaro ($) per i valori di valuta locali. Quando la valuta per la formattazione differisce da quella locale dell'utente, è preferibile utilizzare il codice ISO come stringa di valuta. Potete usare il metodo formattingWithCurrencySymbolIsSafe()
per verificare se il codice ISO della valuta da formattare corrisponde alla proprietà currencyISOCode
del formatter.
Questo metodo consente di formattare i numeri molto grandi o molto piccoli. Il numero di cifre significative è tuttavia limitato dalla precisione fornita dal tipo di dati Number.
Parametri
value:Number — Il valore numerico da formattare in una stringa in valuta.
| |
withCurrencySymbol:Boolean (default = false ) — Quando è impostata su false, la proprietà currencyISOCode determina la stringa o il simbolo di valuta da utilizzare nella stringa di output. Quando è impostata su true, nella stringa di output viene utilizzato il valore corrente della proprietà currencySymbol .
|
String — Una stringa contenente il valore in valuta formattato.
|
Elementi API correlati
currencyISOCode
formattingWithCurrencySymbolIsSafe()
lastOperationStatus
LastOperationStatus
Esempio ( Come utilizzare questo esempio )
withCurrencySymbol
è impostato su true, per formattare l'importo in valuta viene utilizzata la proprietà currencySymbol
.
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 $"
Nel secondo esempio è illustrato un metodo di formattazione di un imposto in valuta in dollari canadesi utilizzando le impostazioni internazionali predefinite dell'utente. Il metodo formattingWithCurrencySymbolIsSafe()
viene utilizzato per verificare se la valuta predefinita dell'utente è il dollaro canadesi e, in caso affermativo, viene utilizzato il metodo format con il parametro withCurrencySymbol
impostato su true. In caso contrario, la valuta è impostata sul dollaro canadese con un simbolo di valuta più descrittivo. Nell'esempio viene illustrato come sarebbe formattata la valuta se le impostazioni internazionali predefinite fossero francese (Canada) o inglese (Stati Uniti).
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" }
formattingWithCurrencySymbolIsSafe | () | metodo |
public function formattingWithCurrencySymbolIsSafe(requestedISOCode:String):Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Determina se il simbolo di valuta attualmente specificato può essere utilizzato per la formattazione degli importi in valuta.
Molti paesi e regioni utilizzano gli stessi simboli di valuta. Potete utilizzare questo metodo per evitare che venga utilizzato un simbolo di valuta ambiguo oppure un simbolo di valuta o un codice ISO diverso da quello previsto a causa dell'uso di impostazioni internazionali di riserva.
È prassi comune utilizzare questo metodo per determinare se visualizzare un simbolo di valuta locale (se l'importo viene formattato nella valuta predefinita dell'utente) o una stringa di codice ISO più specifica (se l'importo viene formattato in una valuta diversa da quella predefinita dell'utente).
Questo metodo confronta il parametro requestedISOCode
con la proprietà currencyISOCode
corrente, restituendo true
se le stringhe corrispondono e false
in caso contrario. Quando le stringhe corrispondono, l'utilizzo del metodo format()
con il parametro withCurrencySymbol
impostato su true
restituisce una stringa di valori di valuta formattata con un simbolo di valuta univoco per il contesto di impostazioni internazionali. Se il metodo restituisce false, l'utilizzo del metodo format()
con il parametro withCurrencySymbol
impostato su true può comportare l'utilizzo di un simbolo di valuta ambiguo o non corretto.
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
requestedISOCode:String — Un codice di valuta ISO 4217 di tre lettere (ad esempio USD per dollari USA, EUR per euro). Deve contenere tre lettere maiuscole dalla A alla Z.
|
Boolean — true se la proprietà currencyISOCode corrisponde al parametro requestedISOCode ; altrimenti false .
|
Genera
TypeError — Se il parametro requestedISOCode è null.
|
Elementi API correlati
getAvailableLocaleIDNames | () | metodo |
public static function getAvailableLocaleIDNames():Vector.<String>
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
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
.
Vector.<String> — Un vettore di stringhe contenente tutti i nomi degli ID di impostazioni internazionali supportati da questa classe.
|
parse | () | metodo |
public function parse(inputString:String):CurrencyParseResult
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Analizza una stringa ottenendo un importo in valuta con simbolo di valuta.
L'algoritmo di analisi utilizza il valore della proprietà decimalSeparator
per determinare la parte intera e frazionaria del numero. Utilizza i valori delle proprietà negativeCurrencyFormat
e positiveCurrencyFormat
per determinare la posizione della stringa o del simbolo di valuta rispetto all'importo in valuta. Per gli importi negativi, il valore della proprietà negativeCurrencyFormat
determina la posizione del simbolo negativo e l'eventuale utilizzo di parentesi.
Se l'ordine del simbolo di valuta, il segno meno, e il numero nella stringa di input non corrispondono allo schema identificato dalle proprietà negativeCurrencyFormat
e positiveCurrencyFormat
, vengono effettuate le seguenti operazioni:
- La proprietà
value
dell'oggetto CurrencyParseResult restituito viene impostata suNaN
. - La proprietà
currencyString
dell'oggetto CurrencyParseResult restituito viene impostata sunull
. - La proprietà
lastOperationStatus
viene impostata in modo da indicare l'esito negativo dell'analisi.
La stringa di input potrebbe includere caratteri spazio, che durante l'analisi vengono ignorati.
L'analisi può avere esito positivo anche se non è presente un simbolo di valuta. Non viene effettuata alcuna convalida Per la parte della stringa che corrisponde al simbolo di valuta non viene effettuata alcuna convalida. Se non è presente una stringa o un simbolo di valuta, la proprietà currencyString
nell'oggetto CurrencyParseResult restituito viene impostata su una stringa vuota.
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
inputString:String — La stringa di input da analizzare.
|
CurrencyParseResult — Un oggetto CurrencyParseResult contenente il valore numerico e la stringa o il simbolo di valuta.
|
Genera
TypeError — Se il parametro inputString è null.
|
Elementi API correlati
setCurrency | () | metodo |
public function setCurrency(currencyISOCode:String, currencySymbol:String):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Imposta le proprietà currencyISOCode
e currencySymbol
dell'oggetto CurrencyFormatter.
Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus
viene impostata su:
LastOperationStatus.NO_ERROR
In caso contrario, le proprietà currencyISOCode
e currencySymbol
non vengono modificate e la proprietà lastOperationStatus
viene impostata su una delle costanti definite nella classe LastOperationStatus
.
Parametri
currencyISOCode:String — Il codice di valuta ISO 4217 di tre lettere (ad esempio USD per dollari USA, EUR per euro). Deve contenere tre lettere maiuscole dalla A alla Z.
| |
currencySymbol:String — La stringa o il simbolo di valuta da utilizzare per la formattazione dei valori di valuta. Può essere una stringa vuota.
|
Genera
TypeError — Se il parametro currencyISOCode o currencySymbol è null.
|
Elementi API correlati
In questo esempio vengono utilizzate le seguenti impostazioni internazionali:
- Le impostazioni internazionali predefinite del sistema operativo per la formattazione della valuta (
LocaleID.DEFAULT
) - Giapponese (Giappone)
- Inglese (Stati Uniti)
- Francese (Francia)
Nell'esempio vengono effettuate le seguenti operazioni per ogni contesto di impostazioni internazionali incluso nell'elenco:
- Crea un oggetto CurrencyFormatter.
- Utilizza il metodo
formattingWithCurrencySymbolIsSafe()
per verificare se la valuta predefinita per le impostazioni internazionali corrisponde a euro ("EUR") e, in tal caso, formatta la stringa utilizzando il simbolo di valuta. Diversamente, formatta la stringa utilizzando il codice ISO.
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); } } } } }
In questo esempio viene eseguita la procedura seguente:
- Crea un oggetto CurrencyFormatter per le impostazioni internazionali Inglese (Stati Uniti).
- Utilizza il metodo
parse()
per analizzare la stringa di input. - Visualizza l'importo e i valori della stringa in valuta dall'oggetto CurrencyParseResult risultante.
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); } } } }
Tue Jun 12 2018, 02:44 PM Z