GlideCurrency Formatter – Umfang

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

Beim Instanziieren des GlideCurrency Formatter-Objekts definieren Sie das Format der Ausgabeergebnisse für dieses Objekt. Sobald festgelegt, wird jedes Mal, wenn Sie aufrufen, dasselbe Format verwendet GlideCurrency Formatter.Format() Methode dieses Objekts. Die GlideCurrency Formatter() Und Format () Methoden sind die einzigen zwei Methoden, die Sie aufrufen müssen, um die FX-Währung zu formatieren.

Die GlideCurrency Formatter() Die API bietet auch optionale Methoden, mit denen Sie:

• Legen Sie das Gebietsschema der Währung mit fest SetGebietsschema () . Durch Festlegen des Gebietsschemas berücksichtigt der Formatierer alle Formatierungen, die für dieses Gebietsschema spezifisch sind, z. B. ob ein Dezimalkomma oder ein Dezimalkomma verwendet wird, um Brüche des Währungsbetrags anzugeben. Standard: Systemgebietsschema
• Legen Sie die Mindestanzahl der anzuzeigenden Bruchziffern fest SetMinFractionDigits() . Definiert die Mindestanzahl von Ziffern rechts neben dem Dezimalkomma/Dezimalkomma, die eingeschlossen werden sollen. Standardmäßig werden alle übergebenen Ziffern angezeigt. Wenn die übergebene Menge weniger Ziffern als das angegebene Minimum aufweist, wird das Ergebnis mit „0“ aufgefüllt.
• Legen Sie die maximale Anzahl von Bruchziffern fest, die mit angezeigt werden sollen SetMaxFractionDigits() . Definiert die maximale Anzahl von Ziffern rechts vom Dezimalkomma/Dezimalkomma, die eingeschlossen werden sollen. Standardmäßig werden alle übergebenen Ziffern angezeigt. Wenn der übergebene Betrag eine größere Anzahl von Ziffern als der angegebene Höchstwert aufweist, werden die zusätzlichen Ziffern während des Rundungsprozesses auf die maximale Anzahl von Bruchziffern gekürzt. Rundung wird auf die nächste Stelle ganz rechts durchgeführt. Wenn beispielsweise die maximale Bruchziffer auf 2 festgelegt ist und der übergebene Währungswert 123.456 ist, ist der formatierte Wert 123.46. Wenn der Währungswert 23.122, ist der formatierte Wert 23.12. Wenn das Maximum auf weniger als das Minimum festgelegt ist, wird der Mindestwert verwendet.

Diese Klasse wird ausgeführt in sn_currency Namespace.

GlideCurrency Formatter: GlideCurrency Formatter(String formatString)

Instanziiert ein GlideCurrency Formatter-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 anrufen GlideCurrency Formatter.Format() Methode zum Formatieren der Währung.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
FormatString	Zeichenfolge	Optional. Formatzeichenfolge, die zum Formatieren einer beliebigen an den Formatierer übergebenen Währung verwendet werden soll. Gültige Werte: %S: Ersetzt durch das Währungssymbol, das dem in angegebenen Ländercode zugeordnet ist Format () Rufen Sie an. %V: Ersetzt durch den Währungsbetrag, z. B. 123.45. %C: Ersetzt durch den in angegebenen ISO-Währungscode Format () Rufen Sie an, z. B. USD oder EUR %L: Durch den übergebenen Wert ersetzt, keine Formatierung durchgeführt. %P: Ersetzt durch Prozentzeichen (%). Wenn die Formatzeichenfolge beispielsweise „%s%V%c“ ist und der zu formatierende Wert 123,45 in US-Dollar ist, beträgt die zurückgegebene formatierte Zeichenfolge 123,45 USD. Wenn die Formatzeichenfolge „%s%l%c“ ist und die zu formatierende Wertzeichenfolge „56M“ in Euro ist, beträgt die zurückgegebene formatierte Zeichenfolge 56 Mio. EUR Hinweis: Jedes Mal wird dieselbe Formatzeichenfolge verwendet Format () Die Methode wird für dieses Objekt aufgerufen.

Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

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

GlideCurrency Formatter – Format(Zeichenfolgenwert, ZeichenfolgenCURRENCYCODE)

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 anfänglichen Instanziierung des GlideCurrency Formatter-Objekts übergeben wurden.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
Wert	Zeichenfolge	Zu formatierender Währungsbetrag. Der Betrag kann nur ein Dezimalzeichen enthalten, um den Bruchbetrag 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. Rückgaben

Typ	Beschreibung
Zeichenfolge	Formatierter Währungswert.

Dieses Beispiel zeigt, 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

GlideCurrency Formatter – setLocale(Zeichenfolgensprache, Zeichenfolgenland)

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

Wenn Sie diese Methode nicht aufrufen, bevor Sie aufrufen GlideCurrency Formatter.Format() Methode: Das Gebietsschema wird standardmäßig auf das Gebietsschema der aktuellen Sitzung gesetzt.

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. USA, es und FR.

Tabelle : 5. Rückgaben

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

GlideCurrency Formatter – setMaxFractionDigits(Number maxFractionDigits)

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

Tabelle : 6. Parameter

Name	Typ	Beschreibung
Max. FractionDigits	Anzahl	Maximale Anzahl zurückzugebender Bruchziffern. Ob dieser Wert auf etwas kleiner als festgelegt ist minFractionDigitsWert, der von überschrieben wird minFractionDigits.

Tabelle : 7. Rückgaben

Typ	Beschreibung
void

Dieses Beispiel zeigt, 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

GlideCurrency Formatter – setMinFractionDigits(Number minFractionDigits)

Legt die Mindestanzahl der zurückzugebenden Bruchziffern (rechts vom Dezimalkomma) fest.

Tabelle : 8. Parameter

Name	Typ	Beschreibung
MinFractionDigits	Anzahl	Mindestanzahl der zurückzugebenden Bruchziffern.

Tabelle : 9. Rückgaben

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