GlideCurrencyFormatter - 범위 지정됨

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

    • GlideCurrencyFormatter API는 FX 통화 문자열의 형식을 지정하는 메서드를 제공합니다.

    GlideCurrencyFormatter 객체를 인스턴스화할 때 이 객체에 대한 출력 결과의 형식을 정의합니다. 일단 설정되면 해당 객체의 GlideCurrencyFormatter.format() 메서드를 호출할 때마다 동일한 형식이 사용됩니다. GlideCurrencyFormatter() 및 format() 메서드는 FX 통화를 포맷하기 위해 호출해야 하는 유일한 두 가지 메서드입니다.

    GlideCurrencyFormatter() API는 다음을 수행할 수 있는 선택적 메서드도 제공합니다.
    • setLocale()을 사용하여 통화의 로케일을 설정합니다. 로캘을 설정하면 포맷터는 해당 로캘과 관련된 모든 형식(예: 통화 금액의 분수를 나타내는 데 소수점 또는 소수 쉼표를 사용하는지 여부)을 고려합니다. 기본값: 시스템 로캘
    • setMinFractionDigits()를 사용하여 표시할 최소 소수 자릿수를 설정합니다. 포함할 소수점/소수점 쉼표의 오른쪽에 있는 최소 자릿수를 정의합니다. 기본적으로 전달된 모든 숫자가 표시됩니다. 전달된 금액의 자릿수가 지정된 최소값보다 적으면 결과는 "0"으로 채워집니다.
    • setMaxFractionDigits()를 사용하여 표시할 최대 소수 자릿수를 설정합니다. 포함할 소수점/소수점 쉼표 오른쪽의 최대 자릿수를 정의합니다. 기본적으로 전달된 모든 숫자가 표시됩니다. 전달된 금액의 자릿수가 지정된 최대값보다 많으면 최대 분수 자릿수로 반올림하는 과정에서 추가 자릿수가 잘립니다. 반올림은 가장 가까운 오른쪽 숫자로 수행됩니다. 예를 들어 최대 분수 자릿수가 2로 설정되고 전달된 통화 값이 123.456인 경우 형식이 지정된 값은 123.46입니다. 통화 값이 23.122인 경우 형식이 지정된 값은 23.12입니다. 최대값이 최소값보다 작게 설정되면 최소값이 사용됩니다.

    이 클래스 실행은 sn_currency 네임스페이스에 있습니다.

    GlideCurrencyFormatter - GlideCurrencyFormatter(문자열 formatString)

    GlideCurrencyFormatter 객체를 인스턴스화하고 FX 통화를 포맷하는 데 사용할 포맷 문자열을 정의합니다.

    이 메서드는 실제 문자열 형식을 수행하지 않습니다. 통화 형식을 지정하려면 GlideCurrencyFormatter.format() 메서드를 호출해야 합니다.

    표 1. 매개변수
    이름 유형 설명
    포맷스트링 문자열 옵션입니다. 포맷터에 전달된 통화의 형식을 지정하는 데 사용할 형식 문자열입니다.

    유효한 값은 다음과 같습니다.

    • %s: format() 호출에 지정된 국가 코드와 관련된 통화 기호로 대체됩니다.
    • %v: 123.45와 같은 통화 금액으로 대체됩니다.
    • %c: format() 호출에 지정된 ISO 통화 코드(예: USD 또는 EUR)로 대체됩니다.
    • %l: 전달된 값으로 대체되고 서식이 지정되지 않습니다.
    • %p: 백분율 기호(%)로 대체됩니다.

    예를 들어 형식 문자열이 '%s%v%c'이고 형식에 대한 값이 미국 달러로 123.45인 경우 반환되는 서식이 지정된 문자열은 $123.45 USD입니다. 형식 문자열이 '%s%l%c'이고 형식을 지정할 값 문자열이 '56M'(유로)인 경우 반환되는 형식이 지정된 문자열은 €56M EUR입니다.

    주:
    이 객체에서 format() 메서드가 호출될 때마다 동일한 형식 문자열이 사용됩니다.

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

    var formatString = '%s%v%c';
var exchangeValue = new sn_currency.GlideCurrencyFormatter(formatString);

    GlideCurrencyFormatter - format(문자열 값, 문자열 currencyCode)

    지정된 통화 코드를 사용하여 지정된 통화 값의 형식을 지정합니다.

    통화의 결과 형식은 GlideCurrencyFormatter 객체가 처음 인스턴스화될 때 전달된 값에 따라서도 달라집니다.

    표 2. 매개변수
    이름 유형 설명
    값 문자열 서식을 지정할 통화 금액입니다. 금액에는 소수 금액을 나타내는 소수점만 포함할 수 있으며 쉼표는 지원되지 않습니다.

    유효한 값: 123.45 또는 2436.23

    잘못된 값 123,45 또는 2,134.56
    currencyCode 문자열 통화 형식을 지정할 때 사용할 세 글자 ISO 통화 코드입니다.
    표 3. 반환
    유형 설명
    문자열 형식화된 통화 값입니다.

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

    var amount = '123456.123456789';
var currencyCode = 'USD';
var formatString = '%s%v%c';
var exchangeValue = new sn_currency.GlideCurrencyFormatter(formatString);
gs.info('Formatted currency: ' + exchangeValue.setMaxFractionDigits(2).format(amount, currencyCode));

    출력:

    Formatted currency: $123,456.12USD

    GlideCurrencyFormatter - setLocale(문자열 언어, 문자열 국가)

    통화 포맷터의 기본 언어와 로캘을 구성하는 국가를 설정합니다.

    GlideCurrencyFormatter.format() 메서드를 호출하기 전에 이 메서드를 호출하지 않으면 로케일은 기본적으로 현재 세션 로케일로 설정됩니다.

    표 4. 매개변수
    이름 유형 설명
    언어 문자열 두 글자 ISO 639 언어 코드(예: en, sp, fr)
    국가 문자열 두 글자 ISO 3166 국가 코드(예: US, ES 및 FR)입니다.
    표 5. 반환
    유형 설명
    void

    이 예제에서는 통화 포맷터를 프랑스로 설정하는 방법을 보여 줍니다.

    var amount = '123456.123456789';
var currencyCode = 'EUR';
var formatString = '%s%v%c';
var exchangeValue = new sn_currency.GlideCurrencyFormatter(formatString);
exchangeValue.setLocale("fr", "FR"); // Language = fr Country = FR
gs.info('Formatted currency: ' + exchangeValue.setMaxFractionDigits(2).format(amount, currencyCode));

    출력:

    Formatted currency: €123 456,12EUR

    GlideCurrency 포매터 - setMaxFractionDigits(Number maxFractionDigits)

    반환할 소수점/소수점 쉼표 오른쪽의 최대 자릿수를 설정합니다.

    표 6. 매개변수
    이름 유형 설명
    maxFractionDigits (영문) 번호 반환할 최대 분수 자릿수입니다. 이 값이 값보다 minFractionDigits 작은 값으로 설정되면 에 의해 minFractionDigits재정의됩니다.
    표 7. 반환
    유형 설명
    void

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

    var amount = '123456.123456789';
var currencyCode = 'USD';
var formatString = '%s%v%c';
var exchangeValue = new sn_currency.GlideCurrencyFormatter(formatString);
gs.info('Formatted currency: ' + exchangeValue.setMaxFractionDigits(2).format(amount, currencyCode));

    출력:

    Formatted currency: $123,456.12USD

    GlideCurrencyFormatter - setMinFractionDigits(숫자 minFractionDigits)

    반환할 최소 소수 자릿수(소수점 오른쪽/소수점 쉼표)를 설정합니다.

    표 8. 매개변수
    이름 유형 설명
    minFractionDigits (영문) 번호 반환할 최소 소수 자릿수입니다.
    표 9. 반환
    유형 설명
    void 
    var amount = '123456.12';
var currencyCode = 'USD';
var formatString = '%s%v%c';
var exchangeValue = new sn_currency.GlideCurrencyFormatter(formatString);
gs.info('Formatted currency: ' + exchangeValue.setMinFractionDigits(3).format(amount, currencyCode));

    출력:

    Formatted currency: $123,456.120USD