GlideCurrencyParser - com escopo

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

Os métodos nesta classe analisam uma cadeia de caracteres especificada em um objeto GlideCurrencyValue, permitindo que você obtenha a formatação de moeda com base na localidade. Antes de chamar o método 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 na chamada do método GlideCurrencyParser.parse() ou chamando GlideCurrencyParser.setDefaultCurrencyCode().

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

Esta classe é executada no namespace sn_currency.

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 da cadeia de caracteres)

Analisa uma cadeia de caracteres especificada em um objeto GlideCurrencyValue para obter a formatação de moeda com base na localidade.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
valor	Cadeia de caracteres	Cadeia de caracteres a ser analisada. Você pode prefixar esta cadeia de caracteres com o código de moeda ISO a ser usado ao analisar a cadeia de caracteres (separados por ponto e vírgula). Se o código da moeda não for definido antes de chamar o método parse(), o padrão será o código da moeda da sessão atual. Este método oferece suporte à notação de ponto decimal e vírgula decimal. Por exemplo: "123,45", "USD;123,45", "123,45", "Euro;123,45"

Tabela 3. Retornos

Tipo	Descrição
GlideCurrencyValue	Informações de valor analisadas. Tipo de dados: objeto

Este exemplo define a localidade como França e analisa o valor da moeda passado para dólares norte-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 norte-americanos e 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 para o 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 norte-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(cadeia de caracteres idioma, cadeia de caracteres país)

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 o método GlideCurrencyParser.parse(), a localidade padrão será 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 de país ISO 3166 de duas letras, como US, 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