CurrencyFormatter  - AS3

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.

1. Wenn das angeforderte Gebietsschema nicht LocaleID.DEFAULT war und das Betriebssystem das angeforderten Gebietsschema unterstützt, ist der zurückgegebene Name identisch mit der requestedLocaleIDName-Eigenschaft.
2. Wenn LocaleID.DEFAULT als Wert für den requestedLocaleIDName-Parameter an den Konstruktor übergeben wurde, wird der Name des aktuellen Gebietsschemas verwendet, der vom Betriebssystem des Benutzers angegeben wird. Der LocaleID.DEFAULT-Wert bewahrt die benutzerdefinierten Einstellungen im Betriebssystem. Mit der Übergabe eines expliziten Werts als requestedLocaleIDName-Parameter wird nicht unbedingt dasselbe Ergebnis erzielt wie mit der Verwendung von LocaleID.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, anstatt LocaleID.DEFAULT zu verwenden, erhält Ihre Anwendung diese benutzerdefinierten Einstellungen nicht.
3. Wenn das System den im Konstruktor angegebenen requestedLocaleIDName nicht unterstützt, wird ein Ersatzgebietsschema bereitgestellt.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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 ($).

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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.

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.

Verwandte API-Elemente

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 der currencySymbol-Eigenschaft ersetzt, abhängig vom Wert des withCurrencySymbol-Parameters, der an die format()-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.

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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 der currencySymbol-Eigenschaft ersetzt, abhängig vom Wert des withCurrencySymbol-Parameters, der an die format()-Methode übergeben wird.
• Das Zeichen 'n' wird durch den Wert des Währungsbetrags ersetzt, der an die format()-Methode übergeben wird.

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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.

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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_WARNING
• LastOperationStatus.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.

Verwandte API-Elemente

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

Verwandte API-Elemente

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

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

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

Verwandte API-Elemente

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.

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:

1. Die value-Eigenschaft des zurückgegebenen CurrencyParseResult-Objekts wird auf NaN gesetzt.
2. Die currencyString-Eigenschaft des zurückgegebenen CurrencyParseResult-Objekts wird auf null gesetzt.
3. 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

Verwandte API-Elemente

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

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:

1. Erstellt ein CurrencyFormatter-Objekt
2. 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:

1. Erstellt ein CurrencyFormatter-Objekt für das Gebietsschema Englisch (USA).
2. Verwendet die parse()-Methode, um den Eingabestring zu analysieren.
3. 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); 
                }
            }
      }
}