GlideCurrencyParser - com escopo

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

Os métodos nesta classe analisam uma cadeia de caracteres especificada em um objeto GlideCurrencyValue, permitindo que você obtenha a formatação de moeda baseada em local. 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 defini-lo por meio do método GlideCurrencyParser.setLocale(), o valor da moeda passado para GlideCurrencyParser.parse() deve estar sem formatação.

Esta classe é executada no namespace sn_currency.

GlideCurrencyParser com escopo — 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

Exemplo

var parser = new sn_currency.GlideCurrencyParser();

GlideCurrencyParser com escopo - parse(cadeia de caracteres value)

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

Tabela 2. Parâmetros

Nome	Tipo	Descrição
valor	Cadeia de caracteres	Cadeia de caracteres a ser analisada. Você pode anexar esta cadeia de caracteres ao 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. Retorna

Tipo	Descrição
GlideCurrencyValue	Informações de valor analisadas. 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 de 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 com escopo - 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. Retorna

Tipo	Descrição
vazio

O exemplo a seguir define o código de 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 com escopo - 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 será padronizada para 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. Retorna

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