GlideCurrencyFormatter - 범위 지정됨

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 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(String 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(String value, String 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

    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