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

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideCurrencyParser - 범위 지정됨

# GlideCurrencyParser - 범위 지정됨 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 4분

GlideCurrencyParser API는 FX 통화 값을 구문 분석하여 로캘 기반 서식을 탐지하는 메서드를 제공합니다.

이 클래스의 메서드는 지정된 문자열을 [GlideCurrencyValue](https://servicenow-prod.fluidtopics.net/CmyDsBhMri6ELuxdEA6xuQ#GlideCurrencyValueScopedAPI "GlideCurrencyValue API는 연결된 GlideCurrencyParser.parse() 호출에서 통화 코드와 원래 통화를 반환하는 메서드를 제공합니다.") 객체로 구문 분석하여 로캘 기반 통화 서식을 얻을 수 있도록 합니다. 실제로 구문 분석을 수행하는 GlideCurrencyParser.parse() 메서드를 호출하기 전에 구문 분석 중에 사용할 통화 코드를 설정해야 합니다. GlideCurrencyParser.parse() 메서드 호출에 전달하거나 GlideCurrencyParser.setDefaultCurrencyCode()를 호출하여 통화 코드를 설정할 수 있습니다.

로케일 설정은 선택 사항입니다. GlideCurrencyParser.setLocale() 메서드를 통해 설정하지 않는 경우 GlideCurrencyParser.parse()에 전달된 통화 금액의 형식을 해제해야 합니다.

이 API는 `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 - 구문 분석(문자열 값) {#ariaid-title3}

지정된 문자열을 GlideCurrencyValue 객체로 구문 분석하여 로컬 기반 통화 서식을 가져옵니다.
{#GCPS-parse_S__table_wpy_532_4jb__entry__3}

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

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 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}

| 이름 | 유형 | 설명 |
|-|-|-|
| 언어 | 문자열 | en, es 및 fr과 같은 두 글자 ISO 639 언어 코드입니다. |
| 국가 | 문자열 | 두 글자 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