GlideCurrencyParser - Com escopo

. GlideCurrencyParser A API fornece métodos para analisar valores de moeda FX para detectar formatação baseada em localidade.

Os métodos nesta classe analisam uma cadeia de caracteres especificada em um GlideCurrencyValue objeto que permite obter formatação de moeda baseada em localidade. Antes de ligar para GlideCurrencyParser.parse() , que realmente executa a análise, você deve definir o código da moeda a ser usado durante a análise. Você pode definir o código da moeda passando-o em GlideCurrencyParser.parse() chamada de método ou por chamada GlideCurrencyParser.setDefaultCurrencyCode() .

Definir a localidade é opcional. Se você não o definir por meio do GlideCurrencyParser.setLocale() método, o valor da moeda passado para GlideCurrencyParser.parse() não deve ser formatado.

Esta API é fornecida no sn_currency namespace.

GlideCurrencyParser - GlideCurrencyParser()

Instancia um objeto GlideCurrencyParser que fornece métodos para analisar uma cadeia de caracteres em um objeto GlideCurrencyValue.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Nenhum(a)

Este exemplo mostra como chamar o método.

var parser = new sn_currency.GlideCurrencyParser();

GlideCurrencyParser - Analisar (valor de cadeia de caracteres)

Analisa uma cadeia de caracteres especificada em um objeto GlideCurrencyValue para obter formatação de moeda baseada em localidade.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
valor	Cadeia de caracteres	Cadeia de caracteres a ser analisada. Esta cadeia de caracteres pode ser precedida com o código da moeda ISO a ser usada ao analisar a cadeia de caracteres (separada por ponto e vírgula). Se o código da moeda não estiver definido antes de chamar analisar() o padrão é o código da moeda da sessão atual. Este método é compatível com notação decimal e vírgula decimal. Por exemplo: "123,45", "USD;123,45", "123,45", "EUR;123,45"

Tabela 3. Retornos

Tipo	Descrição
GlideCurrencyValue	Informações do valor analisado. Tipo de dados: Objeto

Este exemplo define a localidade como França e, em seguida, analisa o valor da moeda passado para dólares americanos.

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

Saída:

USD;1234.56

Este exemplo define o código da moeda padrão como dólares americanos e, em seguida, analisa o valor da moeda.

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

Saída:

USD;1234.56

GlideCurrencyParser - setDefaultCurrencyCode(cadeia de caracteres currencyCode)

Define o código da moeda do objeto GlideCurrencyParser associado.

Tabela 4. Parâmetros

Nome	Tipo	Descrição
currencyCode	Cadeia de caracteres	Código de moeda ISO de três letras a ser usado como padrão no objeto GlideCurrencyParser associado.

Tabela 5. Retornos

Tipo	Descrição
vazio

O exemplo a seguir define o código da moeda padrão como dólares americanos.

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

Saída:

USD;123.45

GlideCurrencyParser - setlocale(idioma da cadeia de caracteres, país da cadeia de caracteres)

Define o idioma padrão e os códigos de país, que constituem a localidade, no objeto GlideCurrencyParser associado.

Se você não chamar este método antes de chamar GlideCurrencyParser.parse() o padrão da localidade é a localidade da sessão atual.

Tabela 6. Parâmetros

Nome	Tipo	Descrição
idioma	Cadeia de caracteres	Código de idioma ISO 639 de duas letras, como en, es e fr.
país	Cadeia de caracteres	Código do país ISO 3166 de duas letras, como EUA, ES e FR.

Tabela 7. Retornos

Tipo	Descrição
vazio

O exemplo a seguir mostra como definir a localidade como Espanha.

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

Saída:

USD;1234.56