---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideWährungFormatter -- Umfang

# GlideWährungFormatter -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 Minuten Lesedauer

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

Beim Instanziieren des GlidewährungsFormatter-Objekts definieren Sie das Format der Ausgabeergebnisse für dieses Objekt. Sobald festgelegt, wird jedes Mal dasselbe Format verwendet, wenn Sie aufrufen GlidewährungFormatter.Format() Methode dieses Objekts. Die GlidewährungsFormatter() Und Format() Methoden sind die einzigen zwei Methoden, die Sie aufrufen müssen, um die FX-Währung zu formatieren.  
Die GlidewährungsFormatter() Die API bietet auch optionale Methoden, mit denen Sie:

* Legen Sie das Gebietsschema der Währung mit fest Gebietsschema festlegen () . Durch 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 Brüche des Währungsbetrags anzugeben. Standard: Systemgebietsschema
* Legen Sie die Mindestanzahl von Teilziffern fest, die mit angezeigt werden sollen SetMinFractionDigits() . Definiert die Mindestanzahl von Ziffern rechts neben dem Dezimalkomma/Dezimalkomma, die eingeschlossen werden sollen. Standardmäßig werden alle übergebenen Ziffern angezeigt. Wenn der übergebene Betrag weniger Ziffern als das angegebene Minimum aufweist, wird das Ergebnis mit „0" aufgefüllt.
* Legen Sie die maximale Anzahl von Teilziffern 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 beim Runden auf die maximale Anzahl von Bruchstellen gekürzt. Rundung wird auf die nächste rechte Stelle durchgeführt. Wenn die maximale Bruchziffer beispielsweise 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.
{#GlideCurrencyFormatterScopedAPI__ul_gtn_n5d_4jb}

Diese Klasse wird ausgeführt in `sn_currency `Namespace.

## GlidewährungsFormatter -- GlidewährungsFormatter(ZeichenfolgenformatString) {#ariaid-title2}

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 GlidewährungFormatter.Format() Methode zum Formatieren der Währung.
{#Scoped-GCF-GlideCurrForm_S__table_g3b_vbc_fy__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| FormatZeichenfolge | 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 (%). {#Scoped-GCF-GlideCurrForm_S__ul_sv5_qzc_4jb} Wenn die Formatzeichenfolge beispielsweise „%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, beträgt die zurückgegebene formatierte Zeichenfolge 56 Mio. EUR Hinweis: Dieselbe Formatzeichenfolge wird jedes Mal verwendet Format() Die Methode wird für dieses Objekt aufgerufen. |
[Tabelle : 1. Parameter]

{#Scoped-GCF-GlideCurrForm_S__table_g3b_vbc_fy}  
Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

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

## GlidewährungsFormatter -- Format(Zeichenfolgenwert, Zeichenfolgenkurve) {#ariaid-title3}

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 GlidewährungsFormatter-Objekts übergeben wurden.
{#Scoped-GCF-format_S_S__table_hxs_f4c_fy__entry__3}

| 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 : 2. Parameter]

{#Scoped-GCF-format_S_S__table_hxs_f4c_fy} {#Scoped-GCF-format_S_S__table_ixs_f4c_fy__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Formatierter Währungswert. |
[Tabelle : 3. Rückgaben]

{#Scoped-GCF-format_S_S__table_ixs_f4c_fy}  
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

## GlidewährungsFormatter -- setLocale (Zeichenfolgensprache, Zeichenfolgenland) {#ariaid-title4}

Legt die Standardsprache und das Standardland, die das Gebietsschema darstellen, für den Währungsformatierer fest.
Wenn Sie diese Methode nicht aufrufen, bevor Sie aufrufen GlidewährungFormatter.Format() Methode: Das Gebietsschema ist standardmäßig das Gebietsschema der aktuellen Sitzung.
{#Scoped-GCF-setLocale_S_S__table_ens_mkc_fy__entry__3}

| 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 : 4. Parameter]

{#Scoped-GCF-setLocale_S_S__table_ens_mkc_fy} {#Scoped-GCF-setLocale_S_S__table_fns_mkc_fy__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 5. Rückgaben]

{#Scoped-GCF-setLocale_S_S__table_fns_mkc_fy}  
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

## GlidewährungsFormatter -- setMaxFractionDigits(Number maxFractionDigits) {#ariaid-title5}

Legt die maximale Anzahl von Ziffern rechts vom Dezimalkomma/Dezimalkomma fest, die zurückgegeben werden sollen.
{#Scoped-GCF-setMaxFractDig_N__table_ltc_1kc_fy__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| MaxFractionDigits | Nummer | Maximale Anzahl zurückzugebender Bruchziffern. Wenn dieser Wert auf etwas kleiner als festgelegt ist minFractionDigitsWert, wird von überschrieben minFractionDigits. |
[Tabelle : 6. Parameter]

{#Scoped-GCF-setMaxFractDig_N__table_ltc_1kc_fy} {#Scoped-GCF-setMaxFractDig_N__table_mtc_1kc_fy__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 7. Rückgaben]

{#Scoped-GCF-setMaxFractDig_N__table_mtc_1kc_fy}  
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

## GlidewährungsFormatter -- setMinFractionDigits(Number minFractionDigits) {#ariaid-title6}

Legt die Mindestanzahl der zurückzugebenden Bruchziffern (rechts vom Dezimalkomma/Dezimalkomma) fest.
{#Scoped-GCF-setMinFranctDig_N__table_hbs_b2c_fy__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| MinFractionDigits | Nummer | Mindestanzahl der zurückzugebenden Bruchziffern. |
[Tabelle : 8. Parameter]

{#Scoped-GCF-setMinFranctDig_N__table_hbs_b2c_fy} {#Scoped-GCF-setMinFranctDig_N__table_ibs_b2c_fy__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 9. Rückgaben]

{#Scoped-GCF-setMinFranctDig_N__table_ibs_b2c_fy}  

    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


