| Paket | flash.globalization |
| Klasse | public final class CurrencyFormatter |
| Vererbung | CurrencyFormatter  Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Die CurrencyFormatter-Klasse verwendet die Daten und Funktionen, die vom Betriebssystem bereitgestellt werden, und wurde entwickelt, um Währungswerte entsprechend den Konventionen eines bestimmten Gebietsschemas und dem Währungstyp zu formatieren. Die Position des Währungssymbols, das Negativsymbol, das Dezimalzeichen, das Gruppierungstrennzeichen, das Gruppierungsmuster und andere Elemente variieren je nach Gebietsschema.
Wenn das Betriebssystem das angeforderte Gebietsschema unterstützt, werden die Eigenschaften und der Währungstyp gemäß den Konventionen und Standards für dieses Gebietsschema festgelegt. Wenn das angeforderte Gebietsschema nicht verfügbar ist, werden die Eigenschaften gemäß einer Ausweichlösung oder dem Standardgebietsschema des Systems (abzurufen mit der actualLocaleIDName-Eigenschaft) eingestellt.
Aufgrund der Verwendung von Benutzereinstellungen, von Formatierungsmustern, die vom Betriebssystem bereitgestellt werden, und von einem Ersatzgebietsschema, falls das angeforderte Gebietsschema nicht unterstützt wird, sehen die Benutzer möglicherweise unterschiedliche Formatierungsergebnisse, selbst wenn sie dasselbe Gebietsschema verwenden.
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
| actualLocaleIDName : String [schreibgeschützt]
Der Name der Gebietsschema-ID, die von diesem CurrencyFormatter-Objekt verwendet wird. | CurrencyFormatter | ||
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| currencyISOCode : String [schreibgeschützt]
Der dreistellige ISO-4217-Währungscode für das verwendete Gebietsschema. | CurrencyFormatter | ||
| currencySymbol : String [schreibgeschützt]
Das Währungssymbol oder der String, der für das Gebietsschema verwendet wird. | CurrencyFormatter | ||
| decimalSeparator : String
Das Dezimaltrennzeichen, das für die Formatierung oder Analyse von Währungsbeträgen mit Dezimalteil verwendet wird. | CurrencyFormatter | ||
| digitsType : uint
Definiert den Satz von Ziffernzeichen, die beim Formatieren von Währungsbeträgen verwendet werden. | CurrencyFormatter | ||
| fractionalDigits : int
Die Höchstzahl von Ziffern, die nach dem Dezimaltrennzeichen erscheinen können. | CurrencyFormatter | ||
| groupingPattern : String
Beschreibt die Platzierung von Tausendertrennzeichen innerhalb des formatierten Währungsbetragsstrings. | CurrencyFormatter | ||
| groupingSeparator : String
Das Zeichen oder der String, das bzw. der als Gruppierungstrennzeichen verwendet wird. | CurrencyFormatter | ||
| lastOperationStatus : String [schreibgeschützt]
Der Status der letzten Operation, die dieses CurrencyFormatter-Objekt ausgeführt hat. | CurrencyFormatter | ||
| leadingZero : Boolean
Gibt an, ob im formatierten Währungsbetrag vorne eine Null angezeigt wird, wenn es keine Ganzzahlen links des Dezimaltrennzeichens gibt. | CurrencyFormatter | ||
| negativeCurrencyFormat : uint
Ein numerischer Wert, der ein Formatierungsmuster für negative Währungsbeträge angibt. | CurrencyFormatter | ||
| negativeSymbol : String
Das Negativsymbol, das bei der Formatierung negativer Währungsbeträge verwendet wird. | CurrencyFormatter | ||
| positiveCurrencyFormat : uint
Ein numerischer Wert, der ein Formatierungsmuster für positive Währungsbeträge angibt. | CurrencyFormatter | ||
| requestedLocaleIDName : String [schreibgeschützt]
Der Name der angeforderten Gebietsschema-ID, der an den Konstruktor dieses CurrencyFormatter-Objekts übergeben wurde. | CurrencyFormatter | ||
| trailingZeros : Boolean
Gibt an, ob nachfolgende Nullen im formatierten Währungsbetrag angezeigt werden. | CurrencyFormatter | ||
| useGrouping : Boolean
Aktiviert die Verwendung des Gruppierungstrennzeichens bei der Formatierung von Währungsbeträgen. | CurrencyFormatter | ||
| Methode | Definiert von | ||
|---|---|---|---|
CurrencyFormatter(requestedLocaleIDName:String)
Konstruiert ein neues CurrencyFormatter-Objekt, um Zahlen, die Währungsbeträge darstellen, entsprechend den Konventionen eines gegebenen Gebietsschemas zu formatieren. | CurrencyFormatter | ||
Erstellt einen String, der einen Währungsbetrag repräsentiert, der entsprechend den aktuellen Eigenschaften dieses CurrencyFormatter-Objekts einschließlich Gebietsschema, Währungssymbol und ISO-Code für die Währung formatiert ist. | CurrencyFormatter | ||
Stellt fest, ob das zurzeit angegebene Währungssymbol bei der Formatierung von Währungsbeträgen verwendet werden kann. | CurrencyFormatter | ||
[statisch]
Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden. | CurrencyFormatter | ||
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
Zerlegt einen String in einen Währungsbetrag und ein Währungssymbol. | CurrencyFormatter | ||
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
Legt die currencyISOCode- und currencySymbol-Eigenschaften des CurrencyFormatter-Objekts fest. | CurrencyFormatter | ||
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
actualLocaleIDName | Eigenschaft |
actualLocaleIDName:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Der Name der Gebietsschema-ID, die von diesem CurrencyFormatter-Objekt verwendet wird.
Es drei Möglichkeiten für den Wert des Namens, abhängig vom Betriebssystem und dem Wert des requestedLocaleIDName-Parameters, der an den CurrencyFormatter()-Konstruktor übergeben wird.
- Wenn das angeforderte Gebietsschema nicht
LocaleID.DEFAULTwar und das Betriebssystem das angeforderten Gebietsschema unterstützt, ist der zurückgegebene Name identisch mit derrequestedLocaleIDName-Eigenschaft. - Wenn
LocaleID.DEFAULTals Wert für denrequestedLocaleIDName-Parameter an den Konstruktor übergeben wurde, wird der Name des aktuellen Gebietsschemas verwendet, der vom Betriebssystem des Benutzers angegeben wird. DerLocaleID.DEFAULT-Wert bewahrt die benutzerdefinierten Einstellungen im Betriebssystem. Mit der Übergabe eines expliziten Werts alsrequestedLocaleIDName-Parameter wird nicht unbedingt dasselbe Ergebnis erzielt wie mit der Verwendung vonLocaleID.DEFAULT, selbst wenn die beiden Gebietsschema-ID-Namen identisch sind. Der Benutzer hat die Gebietsschemaeinstellungen auf seinem Computer möglicherweise angepasst. Wenn Sie einen expliziten Gebietsschema-ID-Namen anfordern, anstattLocaleID.DEFAULTzu verwenden, erhält Ihre Anwendung diese benutzerdefinierten Einstellungen nicht. - Wenn das System den im Konstruktor angegebenen
requestedLocaleIDNamenicht unterstützt, wird ein Ersatzgebietsschema bereitgestellt.
Implementierung
public function get actualLocaleIDName():StringVerwandte API-Elemente
currencyISOCode | Eigenschaft |
currencyISOCode:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Der dreistellige ISO-4217-Währungscode für das verwendete Gebietsschema.
Mit diesem Code wird das Währungssymbol oder der Währungsstring ermittelt, wenn Währungsbeträge mit der format()-Methode formatiert werden, während der withCurrencySymbol-Parameter den Wert false hat.
Diese Eigenschaft wird vom Konstruktor initialisiert, basierend auf dem tatsächlich verwendeten Gebietsschema. Wenn ein Ersatzgebietsschema verwendet wird, gibt diese Eigenschaft den bevorzugten Standardwährungscode für das Ersatzgebietsschema an.
Der Standardwert ist dependent on the actual locale and operating system.
Implementierung
public function get currencyISOCode():StringVerwandte API-Elemente
currencySymbol | Eigenschaft |
currencySymbol:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Das Währungssymbol oder der String, der für das Gebietsschema verwendet wird.
Diese Eigenschaft wird als Währungssymbol verwendet, wenn Währungsbeträge mit der format()-Methode formatiert werden, während der withCurrencySymbol-Parameter den Wert true hat.
Diese Eigenschaft wird vom Konstruktor initialisiert, basierend auf dem tatsächlich verwendeten Gebietsschema. Wenn ein Ersatzgebietsschema verwendet wird, gibt diese Eigenschaft das bevorzugte Standardwährungssymbol für das Ersatzgebietsschema an.
Der Standardwert ist dependent on the actual locale and operating system.
Implementierung
public function get currencySymbol():StringVerwandte API-Elemente
decimalSeparator | Eigenschaft |
decimalSeparator:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Das Dezimaltrennzeichen, das für die Formatierung oder Analyse von Währungsbeträgen mit Dezimalteil verwendet wird.
Diese Eigenschaft wird anfänglich basierend auf dem Gebietsschema, das beim Konstruieren des Formatter-Objekts ausgewählt wurde, festgelegt.
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Der Standardwert ist dependent on the actual locale and operating system.
Implementierung
public function get decimalSeparator():String public function set decimalSeparator(value:String):voidAuslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
digitsType | Eigenschaft |
digitsType:uint| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Definiert den Satz von Ziffernzeichen, die beim Formatieren von Währungsbeträgen verwendet werden.
Verschiedene Sprachen und Regionen verwenden unterschiedliche Zeichengruppen, um die Ziffern 0 bis 9 darzustellen. Diese Eigenschaft definiert die verwendete Zifferngruppe.
Der Wert dieser Eigenschaft repräsentiert den Unicode-Wert für die Ziffer Null einer dezimalen Zifferngruppe. Die gültigen Werte für diese Eigenschaft sind in der NationalDigitsType-Klasse definiert.
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Der Standardwert ist dependent on the actual locale and operating system.
Implementierung
public function get digitsType():uint public function set digitsType(value:uint):voidAuslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
fractionalDigits | Eigenschaft |
fractionalDigits:int| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Die Höchstzahl von Ziffern, die nach dem Dezimaltrennzeichen erscheinen können.
Zahlen werden auf die Anzahl von Ziffern gerundet, die mit dieser Eigenschaft angegeben wird. Das Rundungsschema variiert je nach Betriebssystem des Benutzers.
Wenn die trailingZeros-Eigenschaft den Wert true hat, werden dem gebrochenen Teil der Zahl (nach dem Dezimalzeichen) Nullen nachgestellt, bis die Länge mit dem Wert dieser fractionalDigits-Eigenschaft übereinstimmt.
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Der Standardwert ist 0.
Implementierung
public function get fractionalDigits():int public function set fractionalDigits(value:int):voidVerwandte API-Elemente
groupingPattern | Eigenschaft |
groupingPattern:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Beschreibt die Platzierung von Tausendertrennzeichen innerhalb des formatierten Währungsbetragsstrings.
Wenn die useGrouping-Eigenschaft den Wert „true“ hat, wird die groupingPattern-Eigenschaft verwendet, um die Platzierung und das Muster für das Gruppierungstrennzeichen zu definieren.
Das Gruppierungsmuster wird als String definiert, der Zahlen enthält, die durch Kommas getrennt sind, und der optional mit einem Asterisk enden kann. Beispiel: "3;2;*". Jede Zahl in diesem String repräsentiert die Anzahl der Ziffern in einer Gruppe. Das Gruppierungstrennzeichen wird vor jeder Gruppe von Ziffern platziert. Ein Asterisk am Ende des Strings gibt an, dass Gruppen mit dieser Anzahl von Ziffern für den verbleibenden Rest des Strings wiederholt werden sollen. Fehlt der Asterisk, gibt es im Rest des formatierten Strings keine weiteren Gruppen oder Trennzeichen.
Die erste Zahl im String entspricht der ersten Gruppe von Ziffern links des Dezimaltrennzeichens. Die weiteren Zahlen geben die Anzahl von Ziffern in nach links aufeinander folgenden Gruppen an. Der String "3;2;*" gibt also an, dass ein Gruppierungstrennzeichen nach der ersten Gruppe mit 3 Ziffern gesetzt wird, dann nach der nächsten Gruppe mit 2 Ziffern. Beispiel: 98,76,54,321
In der folgenden Tabelle sind Beispiele für die Formatierung des Währungsbetrags 123456789.12 mit verschiedenen Gruppierungsmustern aufgeführt. Das Gruppierungstrennzeichen ist ein Komma, das Dezimalzeichen ist ein Punkt und das Währungssymbol ist das Dollarzeichen ($).
| Gruppierungsmuster | Beispielformat |
3;* | $123,456,789.12 |
3;2;* | $12,34,56,789.12 |
3 | $123456,789.12 |
Es kann nur eine begrenzte Anzahl von Gruppengrößen definiert werden. Bei einigen Betriebssystemen können Gruppierungsmuster nur zwei Zahlen und einen Asterisk enthalten. Andere Betriebssysteme unterstützen bis zu vier Zahlen und einen Asterisk. Bei Mustern ohne Asterisk unterstützen einige Betriebssystem nur eine Zahl, andere bis zu drei Zahlen. Wenn die maximale Anzahl von Elementen in einem Gruppierungsmuster überschritten wird, werden die überzähligen Elemente ignoriert und die lastOperationStatus-Eigenschaft wird wie unten beschrieben gesetzt.
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Implementierung
public function get groupingPattern():String public function set groupingPattern(value:String):voidAuslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
groupingSeparator | Eigenschaft |
groupingSeparator:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Das Zeichen oder der String, das bzw. der als Gruppierungstrennzeichen verwendet wird.
Der Wert dieser Eigenschaft wird beim Formatieren von Währungsbeträgen als Gruppierungstrennzeichen verwendet, wenn die useGrouping-Eigenschaft den Wert true hat. Diese Eigenschaft wird anfänglich basierend auf dem Gebietsschema, das beim Konstruieren des Formatter-Objekts ausgewählt wurde, festgelegt.
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Der Standardwert ist dependent on the actual locale and operating system.
Implementierung
public function get groupingSeparator():String public function set groupingSeparator(value:String):voidAuslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
lastOperationStatus | Eigenschaft |
lastOperationStatus:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Der Status der letzten Operation, die dieses CurrencyFormatter-Objekt ausgeführt hat. Die lastOperationStatus-Eigenschaft wird immer festgelegt, wenn der Konstruktor oder eine Methode dieser Klasse aufgerufen oder eine andere Eigenschaft festgelegt wird. Die möglichen Werte sind in der Beschreibung der einzelnen Methoden aufgeführt.
Implementierung
public function get lastOperationStatus():StringVerwandte API-Elemente
leadingZero | Eigenschaft |
leadingZero:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Gibt an, ob im formatierten Währungsbetrag vorne eine Null angezeigt wird, wenn es keine Ganzzahlen links des Dezimaltrennzeichens gibt.
Wenn diese Eigenschaft auf true gesetzt ist, wird beim Formatieren von numerischen Werten zwischen -1.0 und 1.0 links des Dezimalzeichens eine Null vorangestellt. Wenn diese Eigenschaft den Wert false hat, wird keine Null vorangestellt.
Wenn der Währungsbetrag zum Beispiel 0.321 lautet und diese Eigenschaft den Wert true hat, wird die vorangestellte Null in den formatierten String einbezogen. Wenn die Eigenschaft den Wert false hat, wird keine Null vor das Dezimalzeichen gesetzt. In diesem Fall enthält der String lediglich das Dezimalzeichen, gefolgt von den Dezimalstellen, also $.321.
Die folgende Tabelle enthält Beispiele für die Formatierung von Währungsbeträgen anhand der Werte für diese Eigenschaft und die verwandten Eigenschaften fractionalDigits und 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 |
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Der Standardwert ist dependent on the actual locale and operating system.
Implementierung
public function get leadingZero():Boolean public function set leadingZero(value:Boolean):voidAuslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
negativeCurrencyFormat | Eigenschaft |
negativeCurrencyFormat:uint| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Ein numerischer Wert, der ein Formatierungsmuster für negative Währungsbeträge angibt. Dieses Muster definiert die Position des Währungssymbols und des Negativsymbols oder von Klammern in Relation zum numerischen Teil des Währungsbetrags.
Der Wert dieser Eigenschaft muss eine der in der folgenden Tabelle definierten Konstanten sein.
In der Tabelle sind die möglichen Formatierungsmuster für negative Währungsbeträge aufgeführt. Wenn ein Währungsbetrag mit der format()-Methode formatiert wird, gilt Folgendes:
- Das Symbol '¤' wird durch den Wert der
currencyISOCode- oder dercurrencySymbol-Eigenschaft ersetzt, abhängig vom Wert deswithCurrencySymbol-Parameters, der an dieformat()-Methode übergeben wird. - Das Zeichen '-' wird durch den Wert der
negativeNumberSymbol-Eigenschaft ersetzt. - Das Zeichen 'n' wird durch den Wert des Währungsbetrags ersetzt, der an die
format()-Methode übergeben wird.
| Formattyp für negative Währungsbeträge | Formatierungsmuster |
| 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 ¤) |
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Der Standardwert ist dependent on the actual locale and operating system.
Implementierung
public function get negativeCurrencyFormat():uint public function set negativeCurrencyFormat(value:uint):voidAuslöser
ArgumentError — wenn der zugewiesene Wert nicht zwischen 0 und 15 liegt.
|
Verwandte API-Elemente
negativeSymbol | Eigenschaft |
negativeSymbol:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Das Negativsymbol, das bei der Formatierung negativer Währungsbeträge verwendet wird.
Dieses Symbol wird mit dem Format für negative Währungsbeträge verwendet, wenn der formatierte Währungsbetrag kleiner als null ist. Es wird nicht verwendet bei Formaten für negative Währungsbeträge, die kein Negativsymbol enthalten (zum Beispiel, wenn negative Währungsbeträge in Klammern gesetzt werden).
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Der Standardwert ist dependent on the actual locale and operating system.
Implementierung
public function get negativeSymbol():String public function set negativeSymbol(value:String):voidAuslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
positiveCurrencyFormat | Eigenschaft |
positiveCurrencyFormat:uint| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Ein numerischer Wert, der ein Formatierungsmuster für positive Währungsbeträge angibt. Dieses Format definiert die Position des Währungssymbols in Relation zum numerischen Teil des Währungsbetrags.
Der Wert dieser Eigenschaft muss eine der in der folgenden Tabelle definierten Konstanten sein.
In der Tabelle sind die möglichen Formatierungsmuster für positive Währungsbeträge aufgeführt. Wenn ein Währungsbetrag mit der format()-Methode formatiert wird, gilt Folgendes:
- Das Symbol '¤' wird durch den Wert der
currencyISOCode- oder dercurrencySymbol-Eigenschaft ersetzt, abhängig vom Wert deswithCurrencySymbol-Parameters, der an dieformat()-Methode übergeben wird. - Das Zeichen 'n' wird durch den Wert des Währungsbetrags ersetzt, der an die
format()-Methode übergeben wird.
| Formattyp für positive Währungsbeträge | Formatierungsmuster |
| 0 | ¤n |
| 1 | n¤ |
| 2 | ¤ n |
| 3 | n ¤ |
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Der Standardwert ist dependent on the actual locale and operating system.
Implementierung
public function get positiveCurrencyFormat():uint public function set positiveCurrencyFormat(value:uint):voidAuslöser
ArgumentError — wenn der zugewiesene Wert nicht zwischen 0 und 3 liegt.
|
Verwandte API-Elemente
requestedLocaleIDName | Eigenschaft |
requestedLocaleIDName:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Der Name der angeforderten Gebietsschema-ID, der an den Konstruktor dieses CurrencyFormatter-Objekts übergeben wurde.
Wenn der Wert LocaleID.DEFAULT verwendet wurde, lautet der zurückgegebene Name "i-default". Das tatsächlich verwendete Gebietsschema kann vom angeforderten Gebietsschema abweichen, wenn ein Ersatzgebietsschema verwendet wird. Der Name des tatsächlich verwendeten Gebietsschemas kann mit der actualLocaleIDName-Eigenschaft abgerufen werden.
Implementierung
public function get requestedLocaleIDName():StringVerwandte API-Elemente
trailingZeros | Eigenschaft |
trailingZeros:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Gibt an, ob nachfolgende Nullen im formatierten Währungsbetrag angezeigt werden.
Wenn diese Eigenschaft den Wert true hat, werden nachfolgende Nullen in den gebrochenen Teil der formatierten Zahl eingeschlossen, und zwar bis zu dem Grenzwert, der mit der fractionalDigits-Eigenschaft festgelegt wurde. Wenn diese Eigenschaft den Wert false hat, werden keine nachfolgenden Nullen hinzugefügt.
Lautet der Währungsbetrag beispielsweise 123.4 und diese Eigenschaft hat den Wert „true“, während die fractionalDigits-Eigenschaft auf „3“ eingestellt ist, werden im formatierten String nachfolgende Nullen bis zur dritten Dezimalstelle angezeigt, also 123.400. Wenn diese Eigenschaft den Wert false hat, werden keine nachfolgenden Nullen angezeigt und der String zeigt nur das Dezimalzeichen, gefolgt von den Dezimalstellen, die nicht null sind, also zum Beispiel $123.4.
Die folgende Tabelle enthält Beispiele für die Formatierung von Währungsbeträgen anhand der Werte für diese Eigenschaft und die verwandten Eigenschaften fractionalDigits und 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 |
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Der Standardwert ist dependent on the actual locale and operating system.
Implementierung
public function get trailingZeros():Boolean public function set trailingZeros(value:Boolean):voidAuslöser
TypeError — wenn dieser Eigenschaft ein null-Wert zugewiesen wird.
|
Verwandte API-Elemente
useGrouping | Eigenschaft |
useGrouping:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Aktiviert die Verwendung des Gruppierungstrennzeichens bei der Formatierung von Währungsbeträgen.
Wenn die useGrouping-Eigenschaft den Wert true hat, werden Ziffern gruppiert und durch ein Gruppierungstrennzeichen getrennt. Beispiel: $123,456,789
Wenn die useGrouping-Eigenschaft den Wert false hat, werden die Ziffern nicht gruppiert oder getrennt. Beispiel: $123456789
Die groupingSeparator-Eigenschaft definiert das Symbol, das als Gruppierungszeichen verwendet wird. Die groupingPattern-Eigenschaft definiert die Anzahl der Ziffern zwischen den Gruppierungszeichen.
Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus-Eigenschaft auf folgenden Wert gesetzt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Implementierung
public function get useGrouping():Boolean public function set useGrouping(value:Boolean):voidVerwandte API-Elemente
CurrencyFormatter | () | Konstruktor |
public function CurrencyFormatter(requestedLocaleIDName:String)| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Konstruiert ein neues CurrencyFormatter-Objekt, um Zahlen, die Währungsbeträge darstellen, entsprechend den Konventionen eines gegebenen Gebietsschemas zu formatieren.
Dieser Konstruktor ermittelt, ob das aktuelle Betriebssystem den angeforderten Gebietsschema-ID-Namen unterstützt. Wenn dieser nicht unterstützt wird, wird stattdessen ein Ersatzgebietsschema verwendet. Wenn ein Ersatzgebietsschema verwendet wird, gibt die lastOperationStatus-Eigenschaft den Typ der Ausweichlösung an und die actualLocaleIDName-Eigenschaft enthält den Namen der Ersatzgebietsschema-ID.
Bestimmte Eigenschaften, zum Beispiel currencySymbol und currencyISOCode, werden automatisch anhand des Gebietsschemas festgelegt.
HINWEIS: Wenn ein Ersatzgebietsschema verwendet wird, werden die Währungseigenschaften auf die Standardwerte gesetzt, weshalb die Eigenschaften currencySymbol oder currencyISOCode möglicherweise unerwartete Werte bekommen. Deshalb empfiehlt es sich, vor dem Formatieren eines Währungsbetrags die Werte der Eigenschaften currencySymbol und currencyISOCode zu untersuchen.
Für die Formatierung anhand der Einstellungen des aktuellen Betriebssystems des Benutzers, übergeben Sie den Wert LocaleID.DEFAULT im requestedLocaleIDName-Parameter an den Konstruktor.
Wenn der Konstruktor aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Wenn der angeforderte Gebietsschema-ID-Name nicht verfügbar ist, hat lastOperationStatus einen der folgenden Werte:
LastOperationStatus.USING_FALLBACK_WARNINGLastOperationStatus.USING_DEFAULT_WARNING
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Details zu den oben aufgeführten Warnungen und zu anderen möglichen Werten der lastOperationStatus-Eigenschaft finden Sie im Abschnitt zur LastOperationStatus-Klasse.
requestedLocaleIDName:String — Der bevorzugte Gebietsschema-ID-Name, der beim Bestimmen von Datums- oder Uhrzeitformaten verwendet wird.
|
Auslöser
TypeError — wenn der requestedLocaleIDName-Parameter den Wert null hat
|
Verwandte API-Elemente
format | () | Methode |
public function format(value:Number, withCurrencySymbol:Boolean = false):String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Erstellt einen String, der einen Währungsbetrag repräsentiert, der entsprechend den aktuellen Eigenschaften dieses CurrencyFormatter-Objekts einschließlich Gebietsschema, Währungssymbol und ISO-Code für die Währung formatiert ist.
Standardmäßig verwendet diese Methode die currencyISOCode-Eigenschaft, um das Währungssymbol und andere Einstellungen für die Formatierung zu ermitteln.
Viele Länder und Regionen verwenden dieselben Währungssymbole für verschiedene Währungen. Die Vereinigten Staaten, Australien, Neuseeland, Kanada und Mexiko verwenden zum Beispiel alle dasselbe Dollarzeichen ($) für lokale Währungswerte. Wenn sich die formatierte Währung von der lokalen Währung des Benutzers unterscheidet, ist es am besten, den ISO-Code als Währungsstring zu verwenden. Mit der formattingWithCurrencySymbolIsSafe()-Methode können Sie testen, ob der ISO-Code der zu formatierenden Währung mit der currencyISOCode-Eigenschaft des Formatters übereinstimmt.
Diese Methode kann sehr große und sehr kleine Zahlen formatieren. Die Anzahl der bedeutenden Ziffern wird jedoch durch die vom Number-Datentyp angegebene Genauigkeit limitiert.
Parameter
value:Number — Der numerische Wert, der in einen Währungsstring formatiert werden soll.
| |
withCurrencySymbol:Boolean (default = false)currencyISOCode-Eigenschaft, welcher Währungsstring bzw. welches Währungssymbol im Ausgabestring verwendet wird. Bei dem Wert „true“ wird der aktuelle Wert der currencySymbol-Eigenschaft im Ausgabestring verwendet.
|
String — Ein String, der den formatierten Währungswert enthält.
|
Verwandte API-Elemente
currencyISOCode
formattingWithCurrencySymbolIsSafe()
lastOperationStatus
LastOperationStatus
Beispiel ( Verwendung dieses Beispiels )
withCurrencySymbol-Parameter den Wert „true“ hat, wird die currencySymbol-Eigenschaft zur Formatierung des Währungsbetrags verwendet.
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 $"
Das zweite Beispiel zeigt eine Methode, mit der ein Währungsbetrag in kanadischen Dollar unter Verwendung des Standardgebietsschemas des Benutzers formatiert wird. Mit der formattingWithCurrencySymbolIsSafe()-Methode wird getestet, ob die Standardwährung des Benutzers der kanadische Dollar ist; wenn dies der Fall ist, wird die Formatierungsmethode mit dem Wert „true“ für den withCurrencySymbol-Parameter verwendet. Andernfalls wird die Währung „kanadischer Dollar“ mit einem aussagekräftigeren Währungssymbol verwendet. Im Beispiel wird gezeigt, wie die Währung formatiert wird, wenn das Standardgebietsschema entweder „Französisch (Kanada)“ oder „Englisch (USA)“ ist.
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 | () | Methode |
public function formattingWithCurrencySymbolIsSafe(requestedISOCode:String):Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Stellt fest, ob das zurzeit angegebene Währungssymbol bei der Formatierung von Währungsbeträgen verwendet werden kann.
In vielen Regionen und Ländern werden dieselben Währungssymbole verwendet. Mit dieser Methode lässt sich verhindern, dass ein mehrdeutiges Währungssymbol verwendet wird, oder Währungssymbole oder ISO-Codes, die wegen der Verwendung eines Ersatzgebietsschemas nicht den erwarteten entsprechen.
Diese Methode wird häufig eingesetzt, um zu bestimmen, ob ein lokales Währungssymbol angezeigt werden soll (wenn der Betrag in der Standardwährung des Benutzers formatiert wird) oder ein genauerer ISO-Code (wenn der Betrag in einer Währung formatiert wird, die nicht dem Standard des Benutzers entspricht).
Die Methode vergleicht den requestedISOCode-Parameter mit der aktuellen currencyISOCode-Eigenschaft. Sie gibt true zurück, wenn die Strings übereinstimmen, false, wenn dies nicht der Fall ist. Stimmen die Strings überein, führt die Verwendung der format()-Methode mit dem withCurrencySymbol-Parameter mit dem Wert true zu einem formatierten Währungswertstring mit einem eindeutigen Währungssymbol für das Gebietsschema. Wenn diese Methode den Wert „false“ zurückgibt, kann die Verwendung der format()-Methode mit dem Wert „true“ für den withCurrencySymbol-Parameter zur Verwendung eines mehrdeutigen oder falschen Währungssymbols führen.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Parameter
requestedISOCode:String — Ein dreistelliger Währungscode gemäß ISO 4217 (zum Beispiel USD für US-Dollar, EUR für Euro). Er muss drei Großbuchstaben von A bis Z enthalten.
|
Boolean — true, wenn die currencyISOCode-Eigenschaft mit dem requestedISOCode-Parameter übereinstimmt; andernfalls false.
|
Auslöser
TypeError — wenn der requestedISOCode-Parameter den Wert null hat
|
Verwandte API-Elemente
getAvailableLocaleIDNames | () | Methode |
public static function getAvailableLocaleIDNames():Vector.<String>| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden.
Wenn diese Klasse vom aktuellen Betriebssystem nicht unterstützt wird, gibt diese Methode einen Null-Wert zurück.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Vector.<String> — Ein Vektor von Strings, der alle von dieser Klasse unterstützten Gebietsschema-ID-Namen enthält.
|
parse | () | Methode |
public function parse(inputString:String):CurrencyParseResult| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Zerlegt einen String in einen Währungsbetrag und ein Währungssymbol.
Der Analysealgorithmus verwendet den Wert der decimalSeparator-Eigenschaft, um den integralen und den gebrochenen Teil der Zahl zu bestimmen. Er verwendet die Werte der negativeCurrencyFormat- und positiveCurrencyFormat-Eigenschaften, um die Position des Währungssymbols oder -strings in Relation zum Währungsbetrag zu ermitteln. Bei negativen Beträgen bestimmt der Wert der negativeCurrencyFormat-Eigenschaft die Position des Negativsymbols und ob Klammern verwendet werden.
Wenn die Reihenfolge des Währungssymbols, des Minuszeichens und der Zahl im Eingabestring nicht mit dem von den Eigenschaften negativeCurrencyFormat und positiveCurrencyFormat definierten Musters übereinstimmt, gilt Folgendes:
- Die
value-Eigenschaft des zurückgegebenen CurrencyParseResult-Objekts wird aufNaNgesetzt. - Die
currencyString-Eigenschaft des zurückgegebenen CurrencyParseResult-Objekts wird aufnullgesetzt. - Die
lastOperationStatus-Eigenschaft gibt an, dass die Analyse fehlgeschlagen ist.
Der Eingabestring kann Leerzeichen enthalten; diese werden bei der Analyse ignoriert.
Die Analyse kann erfolgreich sein, auch wenn kein Währungssymbol vorhanden ist. Der Teil des Strings, der dem Währungssymbol entspricht, wird nicht validiert. Wenn es kein Währungssymbol bzw. keinen Währungsstring gibt, wird die currencyString-Eigenschaft des zurückgegebenen CurrencyParseResult-Objekts auf einen leeren String gesetzt.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Parameter
inputString:String — Der zu analysierende Eingabestring.
|
CurrencyParseResult — Ein CurrencyParseResult-Objekt, das den numerischen Wert und das Währungssymbol bzw. den Währungsstring enthält.
|
Auslöser
TypeError — wenn der inputString-Parameter den Wert null hat
|
Verwandte API-Elemente
setCurrency | () | Methode |
public function setCurrency(currencyISOCode:String, currencySymbol:String):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Legt die currencyISOCode- und currencySymbol-Eigenschaften des CurrencyFormatter-Objekts fest.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls werden die currencyISOCode- und currencySymbol-Eigenschaften nicht geändert und die lastOperationStatus-Eigenschaft wird auf eine der in der LastOperationStatus-Klasse definierten Konstanten gesetzt.
Parameter
currencyISOCode:String — Der dreistellige Währungscode gemäß ISO 4217 (zum Beispiel USD für US-Dollar, EUR für Euro). Er muss drei Großbuchstaben von A bis Z enthalten.
| |
currencySymbol:String — Das Währungssymbol bzw. der Währungsstring, das bzw. der beim Formatieren von Währungswerten verwendet werden soll. Dies kann ein leerer String sein.
|
Auslöser
TypeError — wenn der currencyISOCode- oder currencySymbol-Parameter null ist.
|
Verwandte API-Elemente
Dieses Beispiel verwendet die folgenden Gebietsschemas:
- Das Standardgebietsschema des Betriebssystems für die Währungsformatierung (
LocaleID.DEFAULT) - Japanisch (Japan)
- Englisch (USA)
- Französisch (Frankreich)
Das Beispiel führt für jedes Gebietsschema in der Liste Folgendes aus:
- Erstellt ein CurrencyFormatter-Objekt
- Verwendet die
formattingWithCurrencySymbolIsSafe()-Methode, um zu überprüfen, ob die Standardwährung für das Gebietsschema Euro („EUR“) ist, und formatiert diesen String, falls dies der Fall ist, mit dem Währungssymbol. Andernfalls wird der String mit dem ISO-Code formatiert.
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);
}
}
}
}
}
Dieses Beispiel führt die folgenden Schritte aus:
- Erstellt ein CurrencyFormatter-Objekt für das Gebietsschema Englisch (USA).
- Verwendet die
parse()-Methode, um den Eingabestring zu analysieren. - Zeigt die Werte für den Betrag und den Währungsstring aus dem resultierenden CurrencyParseResult-Objekt an.
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, 10:04 AM Z