GlideCurrencyFormatter – Scoped

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

Wenn Sie das GlideCurrencyFormatter-Objekt instanziieren, definieren Sie das Format der Ausgabeergebnisse für dieses Objekt. Nach der Festlegung 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 für dieses Gebietsschema spezifischen Formatierungen, z. B. ob ein Dezimalpunkt oder ein Dezimalkomma zur Bezeichnung von Bruchteilen des Währungsbetrags verwendet wird. Standard: Systemgebietsschema
• Legen Sie die Mindestanzahl der anzuzeigenden Nachkommastellen mit setMinFractionDigits() fest. Definiert die Mindestanzahl der einzubeziehenden Stellen rechts vom Dezimalzeichen/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 von Stellen rechts vom Dezimalzeichen/Dezimalkomma, die enthalten soll. Standardmäßig werden alle übergebenen Ziffern angezeigt. Wenn der übergebene Betrag eine höhere Anzahl von Stellen als das angegebene Maximum hat, werden die zusätzlichen Stellen beim Runden auf die maximale Anzahl von Nachkommastellen abgeschnitten. Die Rundung erfolgt auf die nächste Ziffer ganz rechts. Beispiel: Wenn die maximale Bruchstelle auf 2 festgelegt ist und der übergebene Währungswert 123,456 ist, lautet der formatierte Wert 123,46. Wenn der Währungswert 23,122 ist, lautet der formatierte Wert 23,12. Wenn das Maximum auf einen geringeren Wert als das Minimum festgelegt ist, wird der Mindestwert verwendet.

Diese Klasse wird im Namespace sn_currency ausgeführt.

Scoped GlideCurrencyFormatter – GlideCurrencyFormatter(String formatString)

Instantiiert 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 aus. Sie müssen die Methode GlideCurrencyFormatter.format() aufrufen, um die Währung zu formatieren.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
formatZeichenfolge	Zeichenfolge	Optional. Formatierungszeichenfolge, die zum Formatieren einer an den Formatierer übergebenen Währung verwendet werden soll. Gültige Werte: %s: Ersetzt durch das Währungssymbol, das dem im format()- Aufruf angegebenen Ländercode zugeordnet ist. %v: Wird durch den Währungsbetrag ersetzt, z. B. 123,45. %c: Ersetzt durch den ISO-Währungscode, der im format() -Aufruf angegeben ist, z. B. USD oder EUR. %l: Durch den übergebenen Wert ersetzt, keine Formatierung durchgeführt. %p: Wird durch das Prozentzeichen (%) ersetzt. Beispiel: Wenn die Formatzeichenfolge '%s%v%c' lautet 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“ und die zu formatierende Wertzeichenfolge „56M“ in Euro lautet, lautet die zurückgegebene formatierte Zeichenfolge 56Mio. EUR. Hinweis: Dieselbe Formatzeichenfolge wird jedes Mal verwendet, wenn die format()- Methode für dieses Objekt aufgerufen wird.

Beispiel

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

Scoped GlideCurrencyFormatter – format(String value, StringwährungsCode)

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

Das resultierende Format der Währung hängt auch von den Werten ab, die übergeben wurden, als das GlideCurrencyFormatter-Objekt anfänglich instanziiert wurde.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
Wert	Zeichenfolge	Zu formatierender Währungsbetrag. Der Betrag darf nur eine Dezimalstelle enthalten, um den Bruchteil des Betrags 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, der beim Formatieren der Währung verwendet werden soll.

Tabelle : 3. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Formatierter Währungswert.

Beispiel

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

Scoped GlideCurrencyFormatter – setLocale(String language, String land)

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

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

Tabelle : 4. Parameter

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

Tabelle : 5. Ergebnisse

Typ	Beschreibung
void

Dieses Beispiel zeigt, wie der Währungsformatierer auf „Frankreich“ festgelegt wird.

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

Scoped GlideCurrencyFormatter – setMaxFractionDigits(Number maxFractionDigits)

Legt die maximale Anzahl von Stellen rechts vom Dezimalzeichen/Dezimalkomma fest, die zurückgegeben werden sollen.

Tabelle : 6. Parameter

Name	Typ	Beschreibung
maxFractionDigits	Nummer	Maximale Anzahl der zurückzugebenden Nachkommastellen. Wenn dieser Wert auf einen kleineren Wert als den Wert minFractionDigits festgelegt ist, wird er von minFractionDigitsüberschrieben.

Tabelle : 7. Ergebnisse

Typ	Beschreibung
void

Beispiel

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

Scoped GlideCurrencyFormatter – setMinFractionDigits(Number minFractionDigits)

Legt die Mindestanzahl von Bruchstellen (rechts vom Dezimalpunkt/Dezimalkomma) für die Rückgabe fest.

Tabelle : 8. Parameter

Name	Typ	Beschreibung
minBractionDigits	Nummer	Mindestanzahl der zurückzugebenden Nachkommastellen.

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