Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Internationalisierung von Anwendungen
Die CurrencyFormatter.setCurrency()-Methode gibt genau an, welcher Währungsstring und welches
Währungssymbol verwendet werden sollen.
Der Code im folgenden Beispiel zeigt Euro-Beträge für Benutzer im französischsprachigen Teil Kanadas an.
var cf:CurrencyFormatter = new CurrencyFormatter( "fr-CA" );
cf.setCurrency("EUR", "€");
trace(cf.format(1234567.89)); // 1.234.567,89 EUR
Mithilfe der setCurrency()-Methode können auch eindeutige Währungssymbole festgelegt werden, um Verwirrung
zu vermeiden: Zum Beispiel:
cf.setCurrency("USD","US$");
Standardmäßig zeigt die format()-Methode einen dreistelligen ISO 4217-Währungscode anstelle des
Währungssymbols an. ISO 4217-Codes sind eindeutig und müssen nicht lokalisiert werden. Viele Benutzer ziehen es
jedoch vor, anstelle der ISO-Codes die Währungssymbole zu sehen.
Die CurrencyFormatter-Klasse hilft Ihnen bei der Entscheidung, welches Symbol ein formatierter Währungsstring
enthalten soll, wie das Dollar- oder Euro-Zeichen oder einen dreistelligen ISO-Währungsstring, wie USD oder EUR.
Beispielsweise kann ein Wert in kanadischen Dollar für Benutzer in Kanada im Format $200 angezeigt werden. Für
Benutzer in den USA wird dagegen CAD 200 angezeigt. Mithilfe der formattingWithCurrencySymbolIsSafe()-
Methode können Sie feststellen, ob das Währungssymbol eines Betrags bei der Gebietsschema-Einstellung des
Benutzers unklar oder falsch wäre.
Im folgenden Beispiel wird ein Euro-Wert für das Gebietsschema „en-US“ formatiert. Je nach Gebietsschema des
Benutzers enthält der Ausgabestring entweder den ISO-Währungscode oder das Währungssymbol.
var cf:CurrencyFormatter = new CurrencyFormatter( "en-CA");
if (cf.formattingWithCurrencySymbolIsSafe("USD"))
{
trace(cf.format(1234567.89, true)); // $1,234,567.89
}
else
{
cf.setCurrency("USD", "$");
trace(cf.format(1234567.89)); // USD1,234,567.89
}
Analysieren von Strings mit Währungswerten
Die CurrencyFormatter-Klasse kann auch einen Währungsbetrag und einen Währungsstring aus einem Eingabestring
extrahieren, der den Formatierungsanforderungen eines bestimmten Gebietsschemas entspricht. Die
CurrencyFormatter.parse()-Methode speichert den analysierten Betrag und den Währungsstring in einem
CurrencyParseResult-Objekt, wie im Folgenden gezeigt:
var cf:CurrencyFormatter = new CurrencyFormatter( "en-US" );
var inputCurrencyString:String = "(GBP 123,56,7.890)";
var parseResult:CurrencyParseResult = cf.parse(inputCurrencyString);
trace("parsed amount: " + parseResult.value); // -1234567.89
trace("currencyString: " + parseResult.currencyString ); // GBP
Der Währungsstring des Eingabestrings kann ein Währungssymbol, einen ISO-Währungscode und zusätzliche
Textzeichen enthalten. Die Positionen des Währungsstrings, des Zeichens für negative Zahlen und des numerischen
Wertes entsprechen den Formaten, die von den negativeCurrencyFormat- und positiveCurrencyFormat-
Eigenschaften angegeben sind. Zum Beispiel:
Letzte Aktualisierung 27.6.2012
1008