---
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


---

# GlideCurrencyConverter - 범위 지정됨

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

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

GlideCurrencyConverter API는 미국 달러를 유럽 유로로 변환하는 것과 같이 한 통화 값을 다른 통화 값으로 변환하는 메서드를 제공합니다.

GlideCurrencyConverter(from, to)를 사용하여 인스턴스화 중에 GlideCurrencyConverter 객체를 인스턴스화하고 소스 및 대상 통화를 정의할 수 있습니다. 이러한 값 없이 객체를 인스턴스화하고 나중에 setFromCurrency() 및 setToCurrency() 메서드를 사용하여 정의할 수도 있습니다. 통화 변환을 수행하기 위해 convert() 메서드를 호출하기 전에 이러한 값과 변환할 금액을 설정해야 합니다. 변환할 금액을 설정하려면 setAmount() 메서드를 사용합니다.  
GlideCurrencyConverter API는 다음을 수행할 수 있는 선택적 메서드도 제공합니다.

* 변환을 수행할 날짜 및 시간을 설정합니다(setDateTime()). 날짜 및 시간을 설정하면 현재 날짜 및 시간의 기본값 대신 지정된 날짜 및 시간에 대한 환산 계산에 사용되는 비율이 됩니다.
* 환산에 사용할 요율 테이블 setRateTable()을 설정합니다. 기본적으로 변환은 fx_system_rate 테이블을 사용하지만 인스턴스에 대한 사용자 지정 요율 테이블을 정의할 수 있습니다. 요율표 생성에 대한 자세한 내용은 [사용자 지정 요율표를 사용하여 환산율 추가를](https://www.servicenow.com/docs/access?context=custom-rate-table&version=australia&pubname=australia-platform-administration&ft:locale=en-US) 참조하세요.
{#GlideCurrencyConverterScopedAPI__ul_wx1_qnw_ljb}

이 API는 `sn_currency` 네임스페이스 내에서 제공됩니다.

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

GlideCurrencyConverter 객체를 인스턴스화합니다.
{#Scoped-GCC-GlideCurrConv__table_xzn_5fw_ljb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 1. 매개변수]

{#Scoped-GCC-GlideCurrConv__table_xzn_5fw_ljb}  
이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    var conv = new sn_currency.GlideCurrencyConverter();

## GlideCurrencyConverter - GlideCurrencyConverter(String from, String to) {#ariaid-title3}

GlideCurrencyConverter 객체를 인스턴스화하고 통화 변환에 사용할 소스 및 대상 국가 코드를 설정합니다.
{#Scoped-GCC-GlideCurrConv_S_S__table_a4p_kjp_cy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 보낸 사람 | 문자열 | 소스 통화의 세 글자 ISO 3166 국가 코드입니다. |
| 대상 | 문자열 | 환산된 통화의 세 글자 ISO 3166 국가 코드입니다. |
[표 2. 매개변수]

{#Scoped-GCC-GlideCurrConv_S_S__table_a4p_kjp_cy}  
이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');

## GlideCurrencyConverter - 변환() {#ariaid-title4}

통화 변환기를 실행합니다.
setAmount(), setRateTable() 및 setDate()와 같이 통화 변환을 구성하는 다른 GlideCurrencyConverter 메서드를 호출한 후 이 메서드를 호출합니다.
{#Scoped-GCC-convert__table_qyh_2hq_cy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 3. 매개변수]

{#Scoped-GCC-convert__table_qyh_2hq_cy} {#Scoped-GCC-convert__table_ryh_2hq_cy__entry__2}

| 유형 | 설명 |
|-|-|
| [GlideCurrencyExchangeValue](https://servicenow-prod.fluidtopics.net/xW7AMnkN~VH3Zn~b~xPITw#GlideCurrencyExchangeValueScopedAPI "GlideCurrencyExchangeValue API는 FX 통화 환산과 관련된 정보에 액세스하는 메서드를 제공합니다.") 객체 | 환산에 대한 상세 정보를 포함하는 GlideCurrencyExchangeValue 객체입니다. CurrencyExchangeValue{ fAmount: Number, fCurrency: "String", fOriginalAmount: Number, fOriginalCurrency: "String", fRate: Number, fRateSysId: "String" } |
| CurrencyExchangeValue.fAmount | 환산된 금액(fOriginalAmount \* fRate). 데이터 유형: 숫자 |
| CurrencyExchangeValue.fCurrency | 변환된 통화의 ISO 4217 알파벳 통화 코드입니다. 데이터 유형: 문자열 |
| CurrencyExchangeValue.fOriginalAmount | 원래 통화 금액입니다. 데이터 유형: 숫자 |
| CurrencyExchangeValue.fOriginalCurrency | 원래 통화의 ISO 4217 알파벳 통화 코드입니다. 데이터 유형: 문자열 |
| CurrencyExchangeValue.fRate | 환산에 사용된 환율입니다. 데이터 유형: 숫자 |
| CurrencyExchangeValue.fRateSysId | 환산에 사용된 환율의 Sys_id입니다. 표: 통화 환산율 \[fx_conversion_rate\] 데이터 유형: 문자열 |
[표 4. 반환]

{#Scoped-GCC-convert__table_ryh_2hq_cy}  
이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
    conv.setAmount(100);
    gs.info(conv.convert());

출력:

    CurrencyExchangeValue{fOriginalAmount=100, fOriginalCurrency='EUR', fRate=1.1604, fAmount=116.04, fCurrency='USD', fRateSysId='4555525f5553445f3230323530383036'}

## GlideCurrencyConverter - setAmount(문자열 금액) {#ariaid-title5}

변환할 통화의 양을 설정합니다.
{#Scoped-GCC-setAmount_S__table_pq4_yxp_cy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 금액 | 문자열 | 변환할 통화 금액입니다. 이 값은 소수 통화를 나타내는 소수점을 제외하고 형식이 지정되지 않아야 합니다. 예를 들어, 1234.56은 유효하고 1,234.56은 유효하지 않습니다. |
[표 5. 매개변수]

{#Scoped-GCC-setAmount_S__table_pq4_yxp_cy} {#Scoped-GCC-setAmount_S__table_qq4_yxp_cy__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 6. 반환]

{#Scoped-GCC-setAmount_S__table_qq4_yxp_cy}  
이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
    conv.setAmount(100);

## GlideCurrencyConverter - setDateTime(객체 날짜) {#ariaid-title6}

통화 환산 날짜 및 시간을 설정합니다.
이 날짜 및 시간은 통화를 변환하는 데 사용되는 환산율을 결정합니다. 이 메서드가 GlideCurrencyConverter.convert() 메서드 전에 호출되지 않으면 현재 날짜/시간의 환율을 사용하여 변환이 수행됩니다.
{#Scoped-GCC-setDateTime_O__table_zxg_cfc_ljb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 날짜 | GlideDateTime | 통화 환산을 계산할 날짜/시간입니다. 이 값은 환산에 사용되는 요율을 결정합니다. |
[표 7. 매개변수]

{#Scoped-GCC-setDateTime_O__table_zxg_cfc_ljb} {#Scoped-GCC-setDateTime_O__table_ayg_cfc_ljb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 8. 반환]

{#Scoped-GCC-setDateTime_O__table_ayg_cfc_ljb}  
다음 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
    conv.setAmount(100);
    var gd = new GlideDateTime("2019-01-03 11:00:00");
    conv.setDateTime(gd);
    gs.info(conv.convert());

출력:

    CurrencyExchangeValue{fOriginalAmount=100, fOriginalCurrency='EUR', fRate=1.061, fAmount=106.1, fCurrency='USD', fRateSysId='4555525f5553445f3130303030313031'}

## GlideCurrencyConverter - setFromCurrency(String from) {#ariaid-title7}

소스 통화의 국가 코드를 설정합니다.
{#Scoped-GCC-setFromCurrency_S__table_wtv_g5p_cy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 보낸 사람 | 문자열 | 소스 통화의 세 글자 ISO 3166 국가 코드입니다. |
[표 9. 매개변수]

{#Scoped-GCC-setFromCurrency_S__table_wtv_g5p_cy} {#Scoped-GCC-setFromCurrency_S__table_xtv_g5p_cy__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 10. 반환]

{#Scoped-GCC-setFromCurrency_S__table_xtv_g5p_cy}  
이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    var conv = new sn_currency.GlideCurrencyConverter().setFromCurrency('FRA');

## GlideCurrencyConverter - setRateTable(String rateTable) {#ariaid-title8}

통화 환산에 사용할 요율 테이블을 정의합니다.
GlideCurrencyConverter.convert() 메서드가 호출되기 전에 이 메서드가 호출되지 않으면 fx_system_rate 테이블을 사용하여 변환이 수행됩니다. 모든 사용자 지정 요율 테이블은 fx_conversion_rate 테이블을 확장해야 합니다. 요율표 생성에 대한 자세한 내용은 [사용자 지정 요율표를 사용하여 환산율 추가를](https://www.servicenow.com/docs/access?context=custom-rate-table&version=australia&pubname=australia-platform-administration&ft:locale=en-US) 참조하세요.
{#Scoped-GCC-setRateTable_S__table_kmn_swp_cy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 레이트 테이블 | 문자열 | 통화 변환에 사용할 요율 테이블의 이름입니다. |
[표 11. 매개변수]

{#Scoped-GCC-setRateTable_S__table_kmn_swp_cy} {#Scoped-GCC-setRateTable_S__table_lmn_swp_cy__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 12. 반환]

{#Scoped-GCC-setRateTable_S__table_lmn_swp_cy}  
이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
    conv.setRateTable(custom_rate_table);

## GlideCurrencyConverter - setToCurrency(String to) {#ariaid-title9}

대상 통화의 국가 코드를 설정합니다.
{#Scoped-GCC-setToCurrency_S__table_wwy_gwp_cy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 대상 | 문자열 | 소스 통화의 세 글자 ISO 3166 국가 코드입니다. |
[표 13. 매개변수]

{#Scoped-GCC-setToCurrency_S__table_wwy_gwp_cy} {#Scoped-GCC-setToCurrency_S__table_xwy_gwp_cy__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 14. 반환]

{#Scoped-GCC-setToCurrency_S__table_xwy_gwp_cy}  
이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    var conv = new sn_currency.GlideCurrencyConverter().setToCurrency('USA');