---
sourceDocument: Xanadu API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ko-KR

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/Gis08r_cIYVHntNCAqceGg#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}

| 이름 | 유형 | 설명 |
|-|-|-|
| 값 | 문자열 | 구문 분석할 문자열입니다. 이 문자열 앞에 문자열을 구문 분석할 때 사용할 ISO 통화 코드(세미콜론으로 구분)를 추가할 수 있습니다. parse() 메서드를 호출하기 전에 통화 코드를 설정하지 않은 경우 기본값은 현재 세션 통화 코드입니다. 이 메서드는 소수점과 10진수 쉼표 표기법을 모두 지원합니다. 예: "123.45", "USD; 123.45", "123,45", "유로; 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 객체에서 기본값으로 사용할 세 글자 ISO 통화 코드입니다. |
[표 4. 매개변수]

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

| 유형 | 설명 |
|-|-|
| void |   |
[표 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(문자열 언어, 문자열 국가) {#ariaid-title5}

연결된 GlideCurrencyParser 객체에서 로캘을 구성하는 기본 언어 및 국가 코드를 설정합니다.
GlideCurrencyParser.parse() 메서드를 호출하기 전에 이 메서드를 호출하지 않으면 로케일은 기본적으로 현재 세션 로케일로 설정됩니다.
{#GCPS-setLocale_S_S__table_e1j_shz_4jb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 언어 | 문자열 | 두 글자 ISO 639 언어 코드(예: en, es 및 fr) |
| 국가 | 문자열 | 두 글자 ISO 3166 국가 코드(예: US, ES 및 FR)입니다. |
[표 6. 매개변수]

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

| 유형 | 설명 |
|-|-|
| void |   |
[표 7. 반환]

{#GCPS-setLocale_S_S__table_f1j_shz_4jb}  
다음 예제에서는 로캘을 Spain으로 설정하는 방법을 보여 줍니다.

    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