GlideCurrencyParser - 범위 지정됨

GlideCurrencyParser API는 FX 통화 값을 구문 분석하여 로캘 기반 서식을 탐지하는 메서드를 제공합니다.

이 클래스의 메서드는 지정된 문자열을 GlideCurrencyValue 객체로 구문 분석하여 로캘 기반 통화 형식을 가져올 수 있습니다. 실제로 구문 분석을 수행하는 GlideCurrencyParser.parse() 메서드를 호출하기 전에 구문 분석 중에 사용할 통화 코드를 설정해야 합니다. GlideCurrencyParser.parse() 메서드 호출에서 통화 코드를 전달하거나 GlideCurrencyParser.setDefaultCurrencyCode()를 호출하여 통화 코드를 설정할 수 있습니다.

로캘 설정은 선택 사항입니다. GlideCurrencyParser.setLocale() 메서드를 통해 설정하지 않는 경우 GlideCurrencyParser.parse()에 전달된 통화 금액의 형식을 해제해야 합니다.

이 API는 sn_currency 네임스페이스 내에서 제공됩니다.

GlideCurrencyParser - GlideCurrencyParser()

문자열을 GlideCurrencyValue 객체로 구문 분석하는 메서드를 제공하는 GlideCurrencyParser 객체를 인스턴스화합니다.

표 1. 매개변수

이름	유형	설명
없음

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

var parser = new sn_currency.GlideCurrencyParser();

GlideCurrencyParser - 구문 분석(문자열 값)

지정된 문자열을 GlideCurrencyValue 객체로 구문 분석하여 로캘 기반 통화 형식을 가져옵니다.

표 2. 매개변수

이름	유형	설명
값	문자열	구문 분석할 문자열입니다. 문자열을 구문 분석할 때 사용할 ISO 통화 코드를 이 문자열 앞에 추가할 수 있습니다(세미콜론으로 구분). parse() 메서드를 호출하기 전에 통화 코드를 설정하지 않으면 기본적으로 현재 세션 통화 코드가 사용됩니다. 이 메서드는 소수점 쉼표 표기법과 소수점 쉼표 표기를 모두 지원합니다. 예: "123.45", "USD; 123.45", "123,45", "유로; 123,45인치

표 3. 반환

유형	설명
GlideCurrencyValue	구문 분석된 값 정보입니다. 데이터 유형: 객체

이 예제에서는 로캘을 프랑스로 설정한 다음 전달된 통화 값을 미국 달러로 구문 분석합니다.

var gp = new sn_currency.GlideCurrencyParser();
gp.setLocale("fr", "FR");
var cv = gp.parse("USD;1234,56");
gs.info(cv);

출력:

USD;1234.56

이 예제에서는 기본 통화 코드를 미국 달러로 설정한 다음 통화 값을 구문 분석합니다.

var amount = "1234.56"
var gp = new sn_currency.GlideCurrencyParser();
gp.setDefaultCurrencyCode("USD");
var cv = gp.parse(amount);
gs.info(cv);

출력:

USD;1234.56

GlideCurrencyParser - setDefaultCurrencyCode(String currencyCode)

연결된 GlideCurrencyParser 객체의 통화 코드를 설정합니다.

표 4. 매개변수

이름	유형	설명
currencyCode	문자열	연결된 GlideCurrencyParser 객체에서 기본값으로 사용할 세 글자 ISO 통화 코드입니다.

표 5. 반환

유형	설명
void

다음 예제에서는 기본 통화 코드를 미국 달러로 설정합니다.

var amount = "123.45"
var gp = new sn_currency.GlideCurrencyParser();
gp.setDefaultCurrencyCode("USD");
var cv = gp.parse(amount);
gs.info(cv);

출력:

USD;123.45

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

연결된 GlideCurrencyParser 객체에서 로케일을 구성하는 기본 언어 및 국가 코드를 설정합니다.

GlideCurrencyParser.parse() 메서드를 호출하기 전에 이 메서드를 호출하지 않으면 로캘이 현재 세션 로캘로 기본 설정됩니다.

표 6. 매개변수

이름	유형	설명
언어	문자열	두 글자 ISO 639 언어 코드(예: en, es 및 fr)
국가	문자열	두 글자 ISO 3166 국가 코드(예: US, ES 및 FR).

표 7. 반환

유형	설명
void

다음 예제에서는 로캘을 Spain으로 설정하는 방법을 보여 줍니다.

var amount = "USD;1.234,56"
var gp = new sn_currency.GlideCurrencyParser();
gp.setLocale("es", "ES");
var cv = gp.parse(amount);
gs.info(cv);

출력:

USD;1234.56