GlideCurrencyConverter - 범위 지정됨

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 7분

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

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

    GlideCurrencyConverter API는 다음을 수행할 수 있는 선택적 메서드도 제공합니다.
    • 변환을 수행할 날짜 및 시간을 설정합니다(setDateTime()). 날짜 및 시간을 설정하면 변환 계산에 사용되는 비율은 현재 날짜 및 시간의 기본값 대신 지정된 날짜 및 시간에 대한 비율입니다.
    • 환산에 사용할 요금표를 설정합니다(setRateTable()). 기본적으로 변환에서는 fx_system_rate 테이블을 사용하지만 인스턴스에 대한 사용자 지정 요율표를 정의할 수 있습니다. 요율표 생성에 대한 자세한 내용은 사용자 지정 요율표를 사용하여 환산율 추가를 참조하세요.

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

    GlideCurrencyConverter - GlideCurrencyConverter ()

    GlideCurrencyConverter 객체를 인스턴스화합니다.

    표 1. 매개변수
    이름 유형 설명
    없음

    이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    var conv = new sn_currency.GlideCurrencyConverter();

    GlideCurrencyConverter - GlideCurrencyConverter(문자열, 문자열로)

    GlideCurrencyConverter 객체를 인스턴스화하고 통화 환산에 사용할 소스 및 대상 국가 코드를 설정합니다.

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

    이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

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

    GlideCurrencyConverter - 변환()

    통화 변환기를 실행합니다.

    통화 변환을 구성하는 다른 GlideCurrencyConverter 메서드(예: setAmount(),setRateTable() 및 setDate())를 호출한 후 이 메서드를 호출합니다.

    표 3. 매개변수
    이름 유형 설명
    없음
    표 4. 반환
    유형 설명
    GlideCurrencyExchangeValue 객체 환산에 대한 상세 정보를 포함하는 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]

    데이터 유형: 문자열

    이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    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(문자열 금액)

    환산할 통화의 양을 설정합니다.

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

    이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

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

    GlideCurrencyConverter - setDateTime(객체 날짜)

    통화 환산 날짜 및 시간을 설정합니다.

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

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

    다음 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    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)

    소스 통화의 국가 코드를 설정합니다.

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

    이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

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

    GlideCurrencyConverter - setRateTable(문자열 rateTable)

    통화 환산에 사용할 요율 테이블을 정의합니다.

    GlideCurrencyConverter.convert() 메서드가 호출되기 전에 이 메서드를 호출하지 않으면 fx_system_rate 테이블을 사용하여 변환이 수행됩니다. 모든 사용자 지정 요율 테이블은 fx_conversion_rate 테이블을 확장해야 합니다. 요율표 생성에 대한 자세한 내용은 사용자 지정 요율표를 사용하여 환산율 추가를 참조하세요.

    표 11. 매개변수
    이름 유형 설명
    rateTable 문자열 통화 환산에 사용할 요율 테이블의 이름입니다.
    표 12. 반환
    유형 설명
    void

    이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

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

    GlideCurrencyConverter - setToCurrency(String to) (GlideCurrencyConverter - setToCurrency(String to) (GlideCurrencyConverter - setToCurrency(문자열 끝)

    대상 통화의 국가 코드를 설정합니다.

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

    이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

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