GlideCurrencyParser - スコープ指定

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：4分

    • 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