GlideCurrencyFormatter: Bereichsbezogen

Die GlideCurrencyFormatter- API bietet Methoden zum Formatieren von FX-Währungszeichenfolgen.

Bei der Instanziierung des GlideCurrencyFormatter-Objekts definieren Sie das Format der Ausgabeergebnisse für dieses Objekt. Einmal festgelegt, wird bei jedem Aufruf der GlideCurrencyFormatter.format()- Methode dieses Objekts dasselbe Format verwendet. Die Methoden GlideCurrencyFormatter() und format() sind die einzigen beiden Methoden, die Sie zum Formatieren der FX-Währung aufrufen müssen.

Die GlideCurrencyFormatter()- API bietet auch optionale Methoden, mit denen Sie:

• Legen Sie das Gebietsschema der Währung mit setLocale() fest. Beim Festlegen des Gebietsschemas berücksichtigt der Formatierer alle Formatierungen, die für dieses Gebietsschema spezifisch sind, z. B. ob ein Dezimalpunkt oder ein Dezimalkomma verwendet wird, um Teile eines Währungsbetrags anzugeben. Standard: Systemgebietsschema
• Legen Sie die Mindestanzahl der anzuzeigenden Nachkommastellen mit setMinFractionDigits() fest. Definiert die Mindestanzahl der Stellen rechts neben dem einzubeziehenden Dezimalpunkt/Dezimalkomma. Standardmäßig werden alle übergebenen Ziffern angezeigt. Wenn der übergebene Betrag weniger Stellen als das angegebene Minimum hat, wird das Ergebnis mit „0“ aufgefüllt.
• Legen Sie die maximale Anzahl der anzuzeigenden Nachkommastellen mit setMaxFractionDigits() fest. Definiert die maximale Anzahl der Stellen rechts neben dem einzubeziehenden Dezimalpunkt/Dezimalkomma. Standardmäßig werden alle übergebenen Ziffern angezeigt. Wenn die Anzahl der Stellen des übergebenen Betrags den angegebenen Höchstwert überschreitet, werden die zusätzlichen Stellen beim Runden auf die Anzahl der maximalen Nachfolgestellen gekürzt. Die Rundung erfolgt auf die nächste Ziffer ganz rechts. Wenn beispielsweise die maximale Bruchziffer auf 2 festgelegt ist und der in der Währung übergebene Wert 123,456 ist, lautet der formatierte Wert 123,46. Wenn der Währungswert 23,122 ist, lautet der formatierte Wert 23,12. Wenn der Höchstwert kleiner als der Mindestwert ist, wird der Mindestwert verwendet.

Diese Klasse wird im Namespace sn_currency ausgeführt.

GlideCurrencyFormatter - GlideCurrencyFormatter(String formatString)

Instanziiert ein GlideCurrencyFormatter-Objekt und definiert die Formatzeichenfolge, die zum Formatieren der FX-Währung verwendet werden soll.

Diese Methode führt nicht das tatsächliche Zeichenfolgenformat durch. Sie müssen die Methode GlideCurrencyFormatter.format() aufrufen, um die Währung zu formatieren.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
formatString	Zeichenfolge	Optional. Formatzeichenfolge zum Formatieren einer beliebigen an den Formatierer übergebenen Währung. Gültige Werte: %s: Wird durch das Währungssymbol ersetzt, das dem im Format () -Aufruf angegebenen Ländercode zugeordnet ist. %v: Wird durch den Währungsbetrag ersetzt, z. B. 123,45. %c: Wird durch den im Format () -Aufruf angegebenen ISO-Währungscode ersetzt, z. B. USD oder EUR. %l: Durch den übergebenen Wert ersetzt, keine Formatierung durchgeführt. %p: Durch das Prozentzeichen (%) ersetzt. Beispiel: Wenn die Formatzeichenfolge „%s%v%c“ ist und der zu formatierende Wert 123,45 in US-Dollar ist, lautet die zurückgegebene formatierte Zeichenfolge 123,45 USD. Wenn die Formatzeichenfolge „%s%l%c“ ist und die zu formatierende Wertzeichenfolge „56M“ in Euro ist, lautet die zurückgegebene formatierte Zeichenfolge 56M Mio. eur. Hinweis: Jedes Mal, wenn die format()- Methode für dieses Objekt aufgerufen wird, wird dieselbe Formatzeichenfolge verwendet.

In diesem Beispiel wird gezeigt, wie die -Methode aufgerufen wird.

var formatString = '%s%v%c';
var exchangeValue = new sn_currency.GlideCurrencyFormatter(formatString);

GlideCurrencyFormatter – Format (Zeichenfolgenwert, Zeichenfolge currencyCode)

Formatiert einen angegebenen Währungswert mit dem angegebenen Währungscode.

Das resultierende Format der Währung hängt auch von den Werten ab, die bei der ersten Instanziierung des GlideCurrencyFormatter-Objekts übergeben wurden.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
Wert	Zeichenfolge	Zu formatierender Währungsbetrag. Der Betrag darf nur einen Dezimalpunkt enthalten, um den Teilbetrag anzugeben. Kommas werden nicht unterstützt. Gültige Werte: 123,45 oder 2436,23 Ungültige Werte 123,45 oder 2.134,56
currencyCode	Zeichenfolge	Dreistelliger ISO-Währungscode für die Formatierung der Währung.

Tabelle : 3. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Formatierter Währungswert.

In diesem Beispiel wird gezeigt, wie die -Methode aufgerufen wird.

var amount = '123456.123456789';
var currencyCode = 'USD';
var formatString = '%s%v%c';
var exchangeValue = new sn_currency.GlideCurrencyFormatter(formatString);
gs.info('Formatted currency: ' + exchangeValue.setMaxFractionDigits(2).format(amount, currencyCode));

Ausgabe:

Formatted currency: $123,456.12USD

GlideCurrencyFormatter - setLocale(Zeichenfolge Sprache, Zeichenfolge Land)

Legt die Standardsprache und das Land, die das Gebietsschema bilden, für den Währungsformatierer fest.

Wenn Sie diese Methode nicht vor dem Aufrufen der GlideCurrencyFormatter.format() -Methode aufrufen, wird als Gebietsschema standardmäßig das aktuelle Sitzungsgebietsschema verwendet.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
language	Zeichenfolge	Zweibuchstabiger ISO 639-Sprachcode, z. B. en, sp und fr.
country	Zeichenfolge	Zweibuchstabiger ISO 3166-Ländercode, z. B. US, ES und FR.

Tabelle : 5. Ergebnisse

Typ	Beschreibung
void

In diesem Beispiel wird der Währungsformatierer auf Frankreich festgelegt.

var amount = '123456.123456789';
var currencyCode = 'EUR';
var formatString = '%s%v%c';
var exchangeValue = new sn_currency.GlideCurrencyFormatter(formatString);
exchangeValue.setLocale("fr", "FR"); // Language = fr Country = FR
gs.info('Formatted currency: ' + exchangeValue.setMaxFractionDigits(2).format(amount, currencyCode));

Ausgabe:

Formatted currency: €123 456,12EUR

GlideCurrencyFormatter – setMaxFractionDigits(Number maxFractionDigits)

Legt die maximale Anzahl der Stellen rechts vom zurückzugebenden Dezimalzeichen/Dezimalkomma fest.

Tabelle : 6. Parameter

Name	Typ	Beschreibung
maxFractionDigits	Nummer	Maximale Anzahl von Bruchteilen, die zurückgegeben werden sollen. Wenn dieser Wert auf einen kleineren Wert als den Wert minFractionDigits festgelegt ist, wird er von minFractionDigitsüberschrieben.

Tabelle : 7. Ergebnisse

Typ	Beschreibung
void

In diesem Beispiel wird gezeigt, wie die -Methode aufgerufen wird.

var amount = '123456.123456789';
var currencyCode = 'USD';
var formatString = '%s%v%c';
var exchangeValue = new sn_currency.GlideCurrencyFormatter(formatString);
gs.info('Formatted currency: ' + exchangeValue.setMaxFractionDigits(2).format(amount, currencyCode));

Ausgabe:

Formatted currency: $123,456.12USD

GlideCurrencyFormatter – setMinFractionDigits(Number minFractionDigits)

Legt die Mindestanzahl der Bruchziffern (rechts vom Dezimalpunkt/Dezimalkomma) fest, die zurückgegeben werden sollen.

Tabelle : 8. Parameter

Name	Typ	Beschreibung
minbruchziffern	Nummer	Mindestanzahl der zurückzugebenden Bruchziffern.

Tabelle : 9. Ergebnisse

Typ	Beschreibung
void

var amount = '123456.12';
var currencyCode = 'USD';
var formatString = '%s%v%c';
var exchangeValue = new sn_currency.GlideCurrencyFormatter(formatString);
gs.info('Formatted currency: ' + exchangeValue.setMinFractionDigits(3).format(amount, currencyCode));

Ausgabe:

Formatted currency: $123,456.120USD