GlideCurrencyParser : Bereichsbezogen

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 ein GlideCurrencyValue- Objekt, mit dem Sie eine gebietsschemabasierte Währungsformatierung erhalten können. Bevor Sie die Methode GlideCurrencyParser.parse() 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 indem Sie GlideCurrencyParser.setDefaultCurrencyCode()aufrufen.

Das Festlegen des Gebietsschemas ist optional. Wenn Sie dies nicht mit der Methode „GlideCurrencyParser.setLocale()“ festlegen, muss der an „GlideCurrencyParser.parse()“ übergebene Währungsbetrag unformatiert sein.

Diese Klasse wird im Namespace sn_currency ausgeführt.

GlideCurrencyParser: GlideCurrencyParser()

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

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

In diesem Beispiel wird gezeigt, wie die -Methode aufgerufen wird.

var parser = new sn_currency.GlideCurrencyParser();

GlideCurrencyParser – parse(Zeichenfolgenwert)

Analysiert eine angegebene Zeichenfolge in ein GlideCurrencyValue-Objekt, um eine 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 Aufrufen der Methode parse() nicht festgelegt wird, wird standardmäßig der Währungscode der aktuellen Sitzung verwendet. Diese Methode unterstützt sowohl die Dezimalpunkt- als auch die Dezimalkomma-Schreibweise. Beispiel: "123,45", "USD;123,45", "123,45", "eur;123,45"

Tabelle : 3. Rückgaben

Typ	Beschreibung
GlideCurrencyValue	Analysierte Wertinformationen. Datentyp: Objekt

In diesem Beispiel wird das Gebietsschema auf Frankreich festgelegt. Anschließend wird der übergebene Währungswert 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. Anschließend wird 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

GlideCurrencyParser – setDefaultCurrencyCode(String currencyCode)

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 zugehörigen GlideCurrencyParser-Objekt verwendet werden soll.

Tabelle : 5. Rückgaben

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

GlideCurrencyParser – setLocale(Zeichenfolge Sprache, Zeichenfolge Land)

Legt die Standardsprach- und Ländercodes, die das Gebietsschema bilden, für das zugeordnete GlideCurrencyParser-Objekt fest.

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

Tabelle : 6. Parameter

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

Tabelle : 7. Rückgaben

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