GlideCurrencyParser – Scoped

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer
  • Die GlideCurrencyParser- API bietet Methoden zum Analysieren von FX-Währungswerten, um gebietsschemabasierte Formatierungen zu erkennen.

    Die Methoden in dieser Klasse analysieren eine angegebene Zeichenfolge in einem GlideCurrencyValue -Objekt, sodass Sie eine gebietsschemabasierte Währungsformatierung erhalten können. Bevor Sie die GlideCurrencyParser.parse() -Methode aufrufen, die die Analyse durchführt, müssen Sie den Währungscode festlegen, der während der Analyse verwendet werden soll. Sie können den Währungscode festlegen, indem Sie ihn entweder im Methodenaufruf GlideCurrencyParser.parse() übergeben oder GlideCurrencyParser.setDefaultCurrencyCode()aufrufen.

    Das Festlegen des Gebietsschemas ist optional. Wenn Sie ihn nicht über die GlideCurrencyParser.setLocale() -Methode festlegen, muss der an GlideCurrencyParser.parse () übergebene Währungsbetrag unformatiert sein.

    Diese Klasse wird im Namespace sn_currency ausgeführt.

    Scoped GlideCurrencyParser – GlideCurrencyParser()

    Instantiiert ein GlideCurrencyParser-Objekt, das Methoden zum Analysieren einer Zeichenfolge in einem GlideCurrencyValue-Objekt bereitstellt.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine

    Beispiel

    var parser = new sn_currency.GlideCurrencyParser();

    Scoped GlideCurrencyParser – parse(String value)

    Analysiert eine angegebene Zeichenfolge in ein GlideCurrencyValue-Objekt, um die gebietsschemabasierte Währungsformatierung zu erhalten.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Wert Zeichenfolge Zu analysierende Zeichenfolge. Sie können dieser Zeichenfolge den ISO-Währungscode voranstellen, der beim Analysieren der Zeichenfolge verwendet werden soll (durch Semikolon getrennt). Wenn der Währungscode vor dem Aufruf der parse() -Methode nicht festgelegt wird, wird standardmäßig der aktuelle Sitzungswährungscode verwendet.

    Diese Methode unterstützt sowohl die Dezimalpunkt- als auch die Dezimalkommaschreibweise.

    Beispiel: "123.45", "USD;123.45", "123,45", "USD;123,45"

    Tabelle : 3. Ergebnisse
    Typ Beschreibung
    GlideCurrencyValue Analysierte Wertinformationen.

    Datentyp: Objekt

    In diesem Beispiel wird das Gebietsschema auf „Frankreich“ festgelegt und der übergebene Währungswert wird dann in US-Dollar analysiert.

    var gp = new sn_currency.GlideCurrencyParser();
    gp.setLocale("fr", "FR");
    var cv = gp.parse("USD;1234,56");
    gs.info(cv);

    Ausgabe:

    USD;1234.56

    In diesem Beispiel wird der Standardwährungscode auf US-Dollar festgelegt und dann der Währungswert analysiert.

    var amount = "1234.56"
    var gp = new sn_currency.GlideCurrencyParser();
    gp.setDefaultCurrencyCode("USD");
    var cv = gp.parse(amount);
    gs.info(cv);

    Ausgabe:

    USD;1234.56

    Scoped GlideCurrencyParser – setDefaultCurrencyCode(StringwährungCode)

    Legt den Währungscode für das zugeordnete GlideCurrencyParser-Objekt fest.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    currencyCode Zeichenfolge Dreistelliger ISO-Währungscode, der als Standard im zugeordneten GlideCurrencyParser-Objekt verwendet werden soll.
    Tabelle : 5. Ergebnisse
    Typ Beschreibung
    void

    Im folgenden Beispiel wird der Standardwährungscode auf US-Dollar festgelegt.

    var amount = "123.45"
    var gp = new sn_currency.GlideCurrencyParser();
    gp.setDefaultCurrencyCode("USD");
    var cv = gp.parse(amount);
    gs.info(cv);

    Ausgabe:

    USD;123.45

    Scoped GlideCurrencyParser – setLocale(String language, String land)

    Legt die standardmäßigen Sprach- und Ländercodes, die das Gebietsschema bilden, für das zugeordnete GlideCurrencyParser-Objekt fest.

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

    Tabelle : 6. Parameter
    Name Typ Beschreibung
    language Zeichenfolge Zweistelliger ISO 639-Sprachcode, z. B. en, es und fr.
    country Zeichenfolge Zweistelliger ISO 3166-Ländercode, z. B. US, ES und FR.
    Tabelle : 7. Ergebnisse
    Typ Beschreibung
    void

    Das folgende Beispiel zeigt, wie das Gebietsschema auf Spanien festgelegt wird.

    var amount = "USD;1.234,56"
    var gp = new sn_currency.GlideCurrencyParser();
    gp.setLocale("es", "ES");
    var cv = gp.parse(amount);
    gs.info(cv);

    Ausgabe:

    USD;1234.56