GlideCurrencyConverter - 범위 지정

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기6분

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

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

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

    이 클래스는 sn_currency 네임스페이스에서 실행됩니다.

    범위가 지정된 GlideCurrencyConverter - convert()

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

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

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

    Rate:수. 변환에 사용되는 환율입니다.

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

    Amount:수. 환산된 금액(OriginalAmountRate*).

    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 - GlideCurrencyConverter()

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

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

    예제

    var conv = new sn_currency.GlideCurrencyConverter();

    범위 지정 GlideCurrencyConverter - GlideCurrencyConverter(String from, String to)

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

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

    예제

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

    범위가 지정된 GlideCurrencyConverter - setAmount(amount 문자열)

    변환할 통화 금액을 설정합니다.

    표 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(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)

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

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

    예제

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