GlideCurrencyParser - スコープ付き

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

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

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

このクラスは sn_currency 名前空間で実行されます。

GlideCurrencyParser - GlideCurrencyParser()

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

表 : 1. パラメーター

名前	タイプ	説明
なし

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

var parser = new sn_currency.GlideCurrencyParser();

GlideCurrencyParser - parse(文字列値)

指定された文字列を解析して GlideCurrencyValue オブジェクトに格納し、ロケールベースの通貨形式を取得できるようにします。

表 : 2. パラメーター

名前	タイプ	説明
value	文字列	解析する文字列です。文字列を解析するときに使用する ISO 通貨コードをこの文字列の先頭に付加できます (セミコロンで区切ります)。parse() メソッドを呼び出す前に通貨コードが設定されていない場合、デフォルトで現在のセッションの通貨コードになります。 このメソッドは、小数点と 10 進数カンマ表記の両方をサポートしています。 例："123.45"、"USD;123.45"、"123,45"、"EUR;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(文字列 language, 文字列 country)

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

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

表 : 6. パラメーター

名前	タイプ	説明
言語	文字列	2 文字の ISO 639 言語コード (en、es、fr など)。
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