GlideCurrencyParser – Scoped
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.
| 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.
| 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" |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| currencyCode | Zeichenfolge | Dreistelliger ISO-Währungscode, der als Standard im zugeordneten GlideCurrencyParser-Objekt verwendet werden soll. |
| 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.
| 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. |
| 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