---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideCurrencyParser - スコープ付き

# GlideCurrencyParser - スコープ付き {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

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

このクラスのメソッドは、指定された文字列を解析して [GlideCurrencyValue](https://servicenow-prod.fluidtopics.net/ck~4oUFVsv9frdDvbnTnNA#GlideCurrencyValueScopedAPI "GlideCurrencyValue API は、関連する GlideCurrencyParser.parse() 呼び出しから通貨コードと元の通貨を返すメソッドを提供します。") オブジェクトに格納し、ロケールベースの通貨形式を取得できるようにします。実際に解析を実行する GlideCurrencyParser.parse() メソッドを呼び出す前に、解析時に使用する通貨コードを設定する必要があります。通貨コードを設定するには、GlideCurrencyParser.parse() メソッド呼び出しで渡すか、GlideCurrencyParser.setDefaultCurrencyCode() を呼び出します。

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

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

## GlideCurrencyParser - GlideCurrencyParser() {#ariaid-title2}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 1. パラメーター]

{#GCPS-GlideCurrencyParser__table_s5m_rh2_4jb}  
この例では、メソッドを呼び出す方法を示します。

    var parser = new sn_currency.GlideCurrencyParser();

## GlideCurrencyParser - parse(文字列値) {#ariaid-title3}

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

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

{#GCPS-parse_S__table_wpy_532_4jb} {#GCPS-parse_S__table_xpy_532_4jb__entry__2}

| タイプ | 説明 |
|-|-|
| GlideCurrencyValue | 解析された値の情報です。 データタイプ: オブジェクト |
[表 : 3. 返される内容]

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

    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) {#ariaid-title4}

関連する GlideCurrencyParser オブジェクトの通貨コードを設定します。
{#GCPS-setDefaultCurrencyCode_S__table_tww_5zz_4jb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| currencyCode | 文字列 | 関連する GlideCurrencyParser オブジェクトでデフォルトとして使用する 3 文字の ISO 通貨コードです。 |
[表 : 4. パラメーター]

{#GCPS-setDefaultCurrencyCode_S__table_tww_5zz_4jb} {#GCPS-setDefaultCurrencyCode_S__table_uww_5zz_4jb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 5. 返される内容]

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

    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) {#ariaid-title5}

ロケールを構成するデフォルトの言語と国コードを、関連する GlideCurrencyParser オブジェクトに設定します。
GlideCurrencyParser.parse() メソッドを呼び出す前にこのメソッドを呼び出さない場合、ロケールはデフォルトで現在のセッションロケールになります。
{#GCPS-setLocale_S_S__table_e1j_shz_4jb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| 言語 | 文字列 | 2 文字の ISO 639 言語コード (en、es、fr など)。 |
| country | 文字列 | 2 文字の ISO 3166 国コードです (US、ES、FR など)。 |
[表 : 6. パラメーター]

{#GCPS-setLocale_S_S__table_e1j_shz_4jb} {#GCPS-setLocale_S_S__table_f1j_shz_4jb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 7. 返される内容]

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

    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