GlideCurrencyConverter - 범위 지정됨

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기7분

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

    GlideCurrencyConverter(from, to)를 사용하여 인스턴스화 중에 GlideCurrencyConverter 객체를 인스턴스화하고 소스 및 대상 통화를 정의할 수 있습니다. 이러한 값 없이 객체를 인스턴스화하고 나중에 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 - 변환()

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

    통화 변환을 구성하는 다른 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. 매개변수
    이름 유형 설명
    날짜 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');