---
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


---

# NummernFormatter: Bereichsbezogen, global

# NummernFormatter: Bereichsbezogen, global {#ariaid-title1}

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

Die NummernFormatter Die API enthält Methoden, die Zahlen zurückgeben, die gemäß der Sprache des aktuellen Anwenders formatiert sind.

Diese API ist in bereichsbezogenen und globalen Apps verfügbar und wird in ausgeführt sn_i18n Namespace.

Bei Formatierung nach Sprache oder Gebietsschema können Anwender Zahlen wie erwartet anzeigen. Beispiel: Wenn das Gebietsschema fr (Französisch) ist, wird ein als 100,00 angegebener Wert als 100,00 zurückgegeben.

## NumberFormatter -- Format(Nummernnummer) {#ariaid-title2}

Gibt eine Zeichenfolgendarstellung einer Zahl zurück, die gemäß der Spracheinstellung des aktuellen Anwenders formatiert ist.
{#NumFormat-format_N__table_nfz_slb_jxb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nummer | Nummer | Anzahl beliebiger Größe. |
[Tabelle : 1. Parameter]

{#NumFormat-format_N__table_nfz_slb_jxb} {#NumFormat-format_N__table_ofz_slb_jxb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Zahl, die gemäß der Spracheinstellung des aktuellen Anwenders formatiert ist. |
[Tabelle : 2. Rückgaben]

{#NumFormat-format_N__table_ofz_slb_jxb}  
Das folgende Beispiel zeigt die Rückgabeergebnisse für einen Anwender, dessen Sprache auf Spanisch festgelegt ist.

    gs.info("Number is: " + sn_i18n.NumberFormatter.format(123456.789));
    gs.info("Number is: " + sn_i18n.NumberFormatter.format(-123456.789));

Ausgabe:

    Number is: 123.456,789
    Number is: -123.456,789

## NumberFormatter -- formatlang(Nummernnummer, Zeichenfolgensprache) {#ariaid-title3}

Gibt eine Zeichenfolgendarstellung einer Zahl zurück, die entsprechend der als Parameter übergebenen Sprache formatiert ist.
{#NumFormat-formatLang_N_S__table_nfz_slb_jxb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nummer | Nummer | Anzahl beliebiger Größe. |
| language | Zeichenfolge | Sprach-Tag gemäß IETF BCP-47. |
[Tabelle : 3. Parameter]

{#NumFormat-formatLang_N_S__table_nfz_slb_jxb} {#NumFormat-formatLang_N_S__table_ofz_slb_jxb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Zahl, die gemäß der als Parameter übergebenen Sprache formatiert ist. |
[Tabelle : 4. Rückgaben]

{#NumFormat-formatLang_N_S__table_ofz_slb_jxb}  
Das folgende Beispiel zeigt die Ausgabe für die deutsche Spracheinstellung.

    gs.info("Number is: " + sn_i18n.NumberFormatter.formatLang(123456.789, "de-de"));
    gs.info("Number is: " + sn_i18n.NumberFormatter.formatLang(-123456.789, "de-de"));

Ausgabe:

    Number is: 123.456,789
    Number is: -123.456,789

## NumberFormatter -- parseWithLocale (Zeichenfolgennummer, Zeichenfolgensprache, Zeichenfolgenland) {#ariaid-title4}

Analysiert eine Zahl aus einer übergebenen Textzeichenfolge, wobei sie von links nach rechts durchläuft, um den numerischen Wert zu extrahieren. Anschließend werden die übergebenen Länder- und Sprachcodes verwendet, um das Gebietsschema der Zahl zu identifizieren, und die analysierte Zahl wird in diesem Format zurückgegeben.
Diese Methode analysiert die Zeichenfolge, bis sie ein Zeichen erreicht, das sie nicht als numerischen Wert oder Währungstrennzeichen erkennt.
{#NumFormat-parseWLocale_S_S_S__table_hmy_qgc_fbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nummer | Zeichenfolge | Zu analysierende Zeichenfolge. Diese Zeichenfolge kann numerische Werte und Währungstrennzeichen wie Kommas und Dezimalstellen enthalten. Beispiel: `„24,506,55" `Oder `„45.677,89" `. |
| language | Zeichenfolge | Zweistelliger ISO-639-Sprachcode. |
| country | Zeichenfolge | Zweistelliger ISO-3166-Ländercode. |
[Tabelle : 5. Parameter]

{#NumFormat-parseWLocale_S_S_S__table_hmy_qgc_fbc} {#NumFormat-parseWLocale_S_S_S__table_imy_qgc_fbc__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Analysierte Zahl im Format des angegebenen Gebietsschemas. Löst eine Ausnahme aus, wenn das erste Zeichen der Zeichenfolge nicht analysiert werden kann. Zum Beispiel: * „123.34": Analysiert zu 123,34, solange das Dezimaltrennzeichen für das Gebietsschema ein Punkt ist. * „1.234,56": Analysiert zu 1234,56, solange das Gebietsschema-Gruppierungstrennzeichen ein Komma und das Dezimaltrennzeichen ein Punkt ist. * „1.234.567,89": Wenn das Gruppierungstrennzeichen nichts als ein Punkt ist, wird zu 1 geparst. * „123 x 456": Analysiert 123. * „Text123": Bewirkt, dass die Methode eine ParseException auslöst. {#NumFormat-parseWLocale_S_S_S__ul_nsz_2kf_gbc} |
[Tabelle : 6. Rückgaben]

{#NumFormat-parseWLocale_S_S_S__table_imy_qgc_fbc}  
Das folgende Codebeispiel zeigt die Analyse von Zeichenfolgen für verschiedene Gebietsschemata sowie die Analyse einer Zeichenfolge mit unerwarteten Trennzeichen. Das letzte Beispiel analysiert die Zeichenfolge nur teilweise, da ein Leerzeichen kein gültiges Trennzeichen ist.

    var x = sn_i18n.NumberFormatter.parseWithLocale("48,837.77", "en", "US");
    var y =  sn_i18n.NumberFormatter.parseWithLocale("77.931,22", "de", "DE");
    var z = sn_i18n.NumberFormatter.parseWithLocale("562 339,89", "fr", "FR");
    var specialCase = sn_i18n.NumberFormatter.parseWithLocale("400 797,67", "en", "US");

    gs.info(x);
    gs.info(y);
    gs.info(z);
    gs.info(specialCase);

Ausgabe:

    48837.77
    77931.22
    562339.89
    400

## NumberFormatter -- parseWithSeparators(Zeichenfolgennummer, ZeichenfolgengruppingSeparator, Zeichenfolge decimalSeparator) {#ariaid-title5}

Analysiert und gibt eine Zahl aus einer übergebenen Textzeichenfolge zurück, wobei sie von links nach rechts durchläuft, bis ein Zeichen gefunden wird, das nicht analysiert werden kann. Analysierbare Werte umfassen Zahlen und die angegebene Gruppierung und Dezimaltrennzeichen.
{#NumFormat-parseWSeparators_S_S_S__table_o4b_rgf_gbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nummer | Zeichenfolge | Zu analysierende Zeichenfolge. Diese Zeichenfolge kann numerische Werte und die angegebenen Trennzeichen wie Kommas und Dezimalstellen enthalten. Beispiel: `„24,506,55" `Oder `„45.677,89" `. |
| GruppierungTrennzeichen | Zeichenfolge | Zeichen, das das Gruppierungstrennzeichen (auch als Tausendertrennzeichen bezeichnet) innerhalb der übergebenen Zeichenfolge angibt. Beispiel: Komma „,", Punkt „." oder Leerzeichen „ ". |
| DezimalSeparator | Zeichenfolge | Zeichen, das das Dezimaltrennzeichen innerhalb der übergebenen Zeichenfolge angibt. Beispiel: Komma „,", Punkt „." oder Leerzeichen „ ". |
[Tabelle : 7. Parameter]

{#NumFormat-parseWSeparators_S_S_S__table_o4b_rgf_gbc} {#NumFormat-parseWSeparators_S_S_S__table_p4b_rgf_gbc__entry__2}

| Typ | Beschreibung |
|-|-|
| Nummer | Analysierte Nummer. Löst eine Ausnahme aus, wenn das erste Zeichen der Zeichenfolge nicht analysiert werden kann. Zum Beispiel: * „123.34": Analysiert zu 123,34, solange das Dezimaltrennzeichen für das Gebietsschema ein Punkt ist. * „1.234,56": Analysiert zu 1234,56, solange das Gebietsschema-Gruppierungstrennzeichen ein Komma und das Dezimaltrennzeichen ein Punkt ist. * „1.234.567,89": Wenn das Gruppierungstrennzeichen nichts als ein Punkt ist, wird zu 1 geparst. * „123 x 456": Analysiert 123. * „Text123": Bewirkt, dass die Methode eine ParseException auslöst. {#NumFormat-parseWSeparators_S_S_S__ul_nsz_2kf_gbc} |
[Tabelle : 8. Rückgaben]

{#NumFormat-parseWSeparators_S_S_S__table_p4b_rgf_gbc}  
Das folgende Codebeispiel zeigt, wie Zahlen mit verschiedenen Trennzeichen analysiert werden. Beachten Sie, dass das endgültige Analysebeispiel nur die ersten drei Ziffern der Zahl analysiert, da ein Leerzeichen kein gültiges Trennzeichen ist.

    var x = sn_i18n.NumberFormatter.parseWithSeparators('48,837.77', ',', '.');
    var y =  sn_i18n.NumberFormatter.parseWithSeparators('77.931,22', '.', ',');
    var z = sn_i18n.NumberFormatter.parseWithSeparators('562 339,89', ' ', ',');
    var specialCase = sn_i18n.NumberFormatter.parseWithSeparators('400 797,67', '.', ',');

    gs.info(x);
    gs.info(y);
    gs.info(z);
    gs.info(specialCase);

Ausgabe:

    48837.77
    77931.22
    562339.89
    400


