GlideCurrencyFormatter - 범위 지정

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

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

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

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

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

    범위가 지정된 GlideCurrencyFormatter - GlideCurrencyFormatter(formatString)

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

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

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

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

    • %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. 매개변수
    이름 유형 설명
    language 문자열 두 글자로 된 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

    범위가 지정된 GlideCurrencyFormatter - 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(Number 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