GlideCurrencyParser - スコープ指定

GlideCurrencyParser API は、FX 通貨値を解析してロケールベースの書式設定を検出するメソッドを提供します。

このクラスのメソッドは、指定された文字列を GlideCurrencyValue オブジェクトに解析し、ロケールベースの通貨書式設定を取得できるようにします。実際に解析を実行する GlideCurrencyParser.parse() メソッドを呼び出す前に、解析中に使用する通貨コードを設定する必要があります。通貨コードを設定するには、 GlideCurrencyParser.parse() メソッド呼び出しで渡すか、 GlideCurrencyParser.setDefaultCurrencyCode() を呼び出します。

ロケールの設定はオプションです。GlideCurrencyParser.setLocale() メソッドを使用してロケールを設定しない場合、GlideCurrencyParser.parse() に渡される通貨金額の形式は設定されません。

この API は sn_currency 名前空間内で提供されます。

GlideCurrencyParser:GlideCurrencyParser()

文字列を解析して GlideCurrencyValue オブジェクトにするメソッドを提供する GlideCurrencyParser オブジェクトをインスタンス化します。

表 : 1. パラメーター

名前	タイプ	説明
なし

この例では、メソッドを呼び出す方法を示します。

var parser = new sn_currency.GlideCurrencyParser();

GlideCurrencyParser - parse(文字列値)

指定された文字列を解析して GlideCurrencyValue オブジェクトにして、ロケールベースの通貨フォーマットを取得します。

表 : 2. パラメーター

名前	タイプ	説明
value	文字列	解析する文字列。この文字列の先頭に ISO 通貨コードを追加して、文字列を解析するときに使用できます (セミコロンで区切って使用)。parse() メソッドを呼び出す前に通貨コードが設定されていない場合、デフォルトは現在のセッション通貨コードになります。 このメソッドは、小数点と小数点の両方のカンマ表記をサポートしています。 例:「123.45」、「USD;123.45」、「123,45」、「ユーロ;123,45インチ

表 : 3. 返される内容

タイプ	説明
GlideCurrencyValue	解析された値情報。 データタイプ: オブジェクト

この例では、ロケールをフランスに設定し、渡された通貨値を米ドルに解析します。

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

出力:

USD;1234.56

この例では、デフォルトの通貨コードを米ドルに設定してから、通貨値を解析します。

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

出力:

USD;1234.56

GlideCurrencyParser - setDefaultCurrencyCode(文字列 currencyCode)

関連する GlideCurrencyParser オブジェクトの通貨コードを設定します。

表 : 4. パラメーター

名前	タイプ	説明
currencyCode	文字列	関連付けられた GlideCurrencyParser オブジェクトでデフォルトとして使用する 3 文字の ISO 通貨コード。

表 : 5. 返される内容

タイプ	説明
なし

次の例では、デフォルトの通貨コードを米ドルに設定します。

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

出力:

USD;123.45

GlideCurrencyParser - setLocale(String language, String country)

ロケールを構成するデフォルトの言語と国コードを、関連する GlideCurrencyParser オブジェクトに設定します。

GlideCurrencyParser.parse() メソッドを呼び出す前にこのメソッドを呼び出しない場合、ロケールはデフォルトで現在のセッションロケールに設定されます。

表 : 6. パラメーター

名前	タイプ	説明
言語	文字列	en、es、fr などの 2 文字の ISO 639 言語コード。
country	文字列	2 文字の ISO 3166 国コード (US、ES、FR など)。

表 : 7. 返される内容

タイプ	説明
なし

次の例は、ロケールをスペインに設定する方法を示しています。

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

出力:

USD;1234.56