CurrencyFormatter  - AS3 Flex

Der Name der Gebietsschema-ID, die von diesem Klassenobjekt verwendet wird. Dies ist das Gebietsschema, das verwendet wird, um auf Formatierungsdaten und Funktionen vom Betriebssystem aus zuzugreifen.

Wenn das vom locale-Stil festgelegte Gebietsschema nicht verfügbar ist, sind der Wert des actualLocaleIDName und der Wert des locale-Stils unterschiedlich. Er gibt das Ersatzgebietsschema an, das verwendet wird. Wenn für den locale-Stil LocaleID.DEFAULT festgelegt wurde, wird der Name des vom Betriebssystem des Benutzers festgelegten Gebietsschemas verwendet.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Verwandte API-Elemente

Der dreistellige ISO-4217-Währungscode für das verwendete Gebietsschema (z. B. USD, EUR, JPY, CNY).

Wenn für die useCurrencySymbol-Eigenschaft false angegeben wird, wird dieser Code bei der Formatierung von Währungsbeträgen mithilfe der format()-Methode zur Angabe des Währungstyps verwendet.

Diese Eigenschaft wird initialisiert, wenn der Gebietsschemastil basierend auf dem verwendeten Gebietsschema festgelegt wird. Wenn ein Ersatzgebietsschema verwendet wird, gibt diese Eigenschaft den bevorzugten Standardwährungscode für das Ersatzgebietsschema an.

Der Standardwert hängt vom Gebietsschema und Betriebssystem ab.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

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 initialisiert, wenn der Gebietsschemastil basierend auf dem verwendeten Gebietsschema festgelegt wird. Wenn ein Ersatzgebietsschema verwendet wird, gibt diese Eigenschaft das bevorzugte Standardwährungssymbol für das Ersatzgebietsschema an. Dieses kann sich vom Gebietsschemastil unterscheiden.

Der Standardwert hängt vom Gebietsschema und Betriebssystem ab.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

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.

Der Standardwert hängt vom Gebietsschema und Betriebssystem ab.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

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.

Der Standardwert hängt vom Gebietsschema und Betriebssystem ab.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Verwandte API-Elemente

Aktiviert die Verwendung der currencySymbol-Eigenschaft bei der Formatierung von Währungsbeträgen.

Wenn für die useCurrencySymbol-Eigenschaft true festgelegt ist, wird der Wert der currencySymbol-Eigenschaft im durch die format-Methode zurückgegebenen String verwendet. Beispiel: $123,456,789.22

Wenn für die useCurrencySymbol-Eigenschaft false festgelegt ist, wird der Wert der currencyISOCode-Eigenschaft im durch die format-Methode zurückgegebenen String verwendet. Beispiel: USD 123,456,789.22

Der Standardwert ist false.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Verwandte API-Elemente

Konstruiert ein neues CurrencyFormatter-Objekt, um Zahlen, die Währungsbeträge darstellen, entsprechend den Konventionen eines gegebenen Gebietsschemas zu formatieren.

Das Gebietsschema für diese Klasse wird vom Gebietsschema-Stil bereitgestellt. Der Gebietsschema-Stil kann auf verschiedene Arten festgelegt werden:

• Durch Verwenden der Klasse in einer MXML-Deklaration und Übernehmen des Gebietsschemas aus dem Dokument, das die Deklaration enthält.
Beispiel:

      <fx:Declarations> 
             <s:CurrencyFormatter id="cf" /> 
      </fx:Declarations>
      

• Durch Verwenden einer MXML-Deklaration und Festlegen des Gebietsschemawerts in der Liste mit Zuweisungen.
Beispiel:

      <fx:Declarations> 
          <s:CurrencyFormatter id="cf_Japanese" locale="ja-JP" /> 
      </fx:Declarations>
      

• Aufrufen der setStyle()-Methode, z. B. cf.setStyle("locale", "ja-JP")
• Übernehmen des Stils aus einer UIComponent durch Aufruf der addStyleClient()-Methode der UIComponent.

Wenn der locale-Stil nicht durch eine der oben beschriebenen Methoden festgelegt wird, wird die Instanz dieser Klasse als StyleClient der topLevelApplication hinzugefügt und übernimmt daher den locale-Stil aus dem topLevelApplication-Objekt, wenn die locale-abhängige Get-Funktion oder locale-abhängige Methode aufgerufen wird.

Die meisten Eigenschaften dieser Klasse werden automatisch basierend auf dem locale-Stil festgelegt. Wenn der locale-Stil geändert wird, werden auch alle Eigenschaften, die nicht explizit festgelegt wurden, basierend auf dem neuen Gebietsschema aktualisiert. Beachten Sie, dass das verwendete Gebietsschema von der actualLocaleIDName-Eigenschaft festgelegt wird.

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.

Verwandte API-Elemente

Erstellt einen String, der einen Währungsbetrag repräsentiert, der entsprechend den aktuellen Eigenschaften dieses CurrencyFormatter-Objekts einschließlich der Eigenschaften locale, useCurrencySymbol, currencySymbol oder currencyISOCode formatiert ist.

Die useCurrencySymbol-Eigenschaft bestimmt, ob die format-Methode currencySymbol oder currencyISOCode im formatierten Währungsbetrag verwendet. Der Standardwert für useCurrencySymobl ist false. Währungsbeträge werden also standardmäßig mit currencyISOCode formatiert.

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. Mithilfe der formattingWithCurrencySymbolIsSafe()-Methode können Sie testen, ob der ISO-Code der zu formatierenden Währung mit dem Standard-ISO-Code der Währung für das tatsächliche vom Formatter verwendete Gebietsschema übereinstimmt.

Diese Methode kann sehr große und sehr kleine Zahlen formatieren. Die Anzahl der gültigen Ziffern wird jedoch durch die vom Number-Datentyp angegebene Genauigkeit limitiert.

Wenn aufgrund eines unzulässigen Eingabewerts oder anderen Fehlers ein Fehler beim Formatieren auftritt, gibt die format()-Methode standardmäßig null zurück. Wenn die errorText-Eigenschaft jedoch ungleich null ist, wird der Wert der errorText-Eigenschaft zurückgegeben. Die lastOperationStatus-Eigenschaft wird festgelegt, um den aufgetretenen Fehler anzugeben.

Parameter

Verwandte API-Elemente

      <fx:Declarations>
        <s:CurrencyFormatter id="cf_use_ISOCode" locale="fr-CA" />
        <s:CurrencyFormatter id="cf_use_Symbol" locale="fr-CA" 
                           useCurrencySymbol="true" />
      </fx:Declarations>
      
      <s:VGroup>
        <!-- label will use ISO code: 1,234,567.89 CAD -->
        <s:Label text="{cf_use_ISOCode.format(1234567.89)}" /> 
        <!-- label will use currency symbol: 1,234,567.89 $ -->
        <s:Label text="{cf_use_Symbol.format(1234567.89)}" /> 
      </s:VGroup>
     
      

      <fx:Declarations>
       <s:CurrencyFormatter id="cf_CAD" locale="{LocaleID.DEFAULT}"
        currencyISOCode="CAD"
        useCurrencySymbol="{cf_CAD.formattingWithCurrencySymbolIsSafe('CAD')}"
       />
      </fx:Declarations>
      
      <fx:Script>
      <![CDATA[
          import flash.globalization.LocaleID;
      ]]>
      </fx:Script>
      
      <!-- label will use ISO code or currency symbol depending on
              user's default locale -->
      <s:Label text="{cf_CAD.format(1234567.89)}" />
      

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

Diese Methode vergleicht den requestedISOCode-Parameter mit dem standardmäßigen currencyISOCode des tatsächlichen Gebietsschemas. 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, wobei die useCurrencySymbol-Eigenschaft den Wert true hat, zu einem formatierten Währungswertstring mit einem 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 die useCurrencySymbol-Eigenschaft zur Verwendung eines mehrdeutigen oder falschen Währungssymbols führen.

Parameter

Verwandte API-Elemente

Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden. Dies ist eine Liste von Gebietsschemas, die vom Betriebssystem unterstützt werden. Dies ist keine Liste von Gebietsschemas, für die der ResourceManager Ressourcen hat.

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. Für die lastOperationStatus-Eigenschaft wird LastOperationStatus.PARSE_ERROR festgelegt, um anzuzeigen, 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.

Parameter

Verwandte API-Elemente