GlideCurrencyConverter - 범위 지정됨

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기7분

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

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

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

    이 클래스 실행은 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 - convert()

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

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

    표 3. 매개변수
    이름 유형 설명
    없음
    표 4. 반환
    유형 설명
    객체 변환에 성공하면 CurrencyExchangeValue 개체를 반환합니다. 실패하면 "null"을 반환합니다.
    CurrencyExchangeValue {
Rate: Number,
OriginalAmount: Number,
Amount: Number,
fromCurrency: String,
toCurrency: String,
rateSysId: String
}

    Rate:수. 환산에 사용된 환율입니다.

    OriginalAmount:수. 소스 통화 금액입니다.

    Amount:수. 환산 금액 (OriginalAmount * Rate).

    fromCurrency:문자열. 소스 통화의 세 글자 ISO 3166 국가 코드입니다.

    toCurrency:문자열. 변환된 통화의 세 글자 ISO 3166 국가 코드입니다.

    rateSysId:문자열. 환산을 계산하는 데 사용된 요율 테이블 기록의 Sys_id입니다.

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

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

    출력:

    CurrencyExchangeValue{Rate = 1.0777, OriginalAmount = 100, Amount = 107.7700, fromCurrency = 'EUR', toCurrency = 'USD', rateSysId = '2ed537fcb271937adb'}

    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. 매개변수
    이름 유형 설명
    날짜 GlideDateTime 통화 환산을 계산할 날짜/시간입니다. 이 값은 변환에 사용되는 비율을 결정합니다.
    표 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(문자열)

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

    표 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(문자열 to)

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

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

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

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