GlideCurrencyFormatter - com escopo

A API GlideCurrencyFormatter fornece métodos para formatar cadeias de caracteres de moeda FX.

Ao instanciar o objeto GlideCurrencyFormatter, você define o formato dos resultados de saída para este objeto. Depois de definido, o mesmo formato é usado sempre que você chama o método GlideCurrencyFormatter.format() desse objeto. Os métodos GlideCurrencyFormatter() e format() são os únicos dois métodos que você deve chamar para formatar moeda FX.

A API GlideCurrencyFormatter() também fornece métodos opcionais que permitem:

• Defina a localidade da moeda usando setLocale(). Ao definir a localidade, o formatador leva em consideração qualquer formatação específica dessa localidade, como se um ponto decimal ou vírgula decimal é usado para denotar frações do valor da moeda. Padrão: localidade do sistema
• Defina o número mínimo de dígitos fracionários a serem exibidos usando setMinFractionDigits(). Define o número mínimo de dígitos à direita do ponto decimal/vírgula decimal a serem incluídos. Por padrão, todos os dígitos passados são exibidos. Se o valor passado tiver menos dígitos do que o mínimo especificado, o resultado será preenchido com "0".
• Defina o número máximo de dígitos fracionários a serem exibidos usando setMaxFractionDigits(). Define o número máximo de dígitos à direita do ponto decimal/vírgula decimal a serem incluídos. Por padrão, todos os dígitos passados são exibidos. Se o valor passado tiver um número de dígitos maior do que o máximo especificado, os dígitos adicionais serão truncados durante o processo de arredondamento para o número máximo de dígitos de frações. O arredondamento é realizado para o dígito mais próximo à extrema direita. Por exemplo, se o dígito máximo da fração estiver definido como 2 e o valor da moeda passado for 123,456, o valor formatado será 123,46. Se o valor da moeda for 23,122, o valor formatado será 23,12. Se o máximo for definido como menor que o mínimo, o valor mínimo será usado.

Esta classe é executada no namespace sn_currency.

GlideCurrencyFormatter com escopo - GlideCurrencyFormatter(cadeia de caracteres formatString)

Instancia um objeto GlideCurrencyFormatter e define a cadeia de caracteres de formato a ser usada para formatar a moeda FX.

Este método não executa o formato de cadeia de caracteres real. Você deve chamar o método GlideCurrencyFormatter.format() para formatar a moeda.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
cadeia de caracteres de formato	Cadeia de caracteres	Opcional. Cadeia de caracteres de formato a ser usada para formatar qualquer moeda passada para o formatador. Valores válidos: %s: substituído pelo símbolo da moeda associado ao código do país especificado na chamada format(). %v: substituído pelo valor da moeda, como 123,45. %c: substituído pelo código de moeda ISO especificado na chamada format(), como USD ou EUR. %l: substituído pelo valor passado, nenhuma formatação realizada. %p: substituído pelo sinal de porcentagem (%). Por exemplo, se a cadeia de caracteres de formato for "%s%v%c" e o valor a ser formatado for 123,45 em dólares americanos, a cadeia de caracteres formatada retornada será $123,45. Se a cadeia de caracteres de formato for "%s%l%c" e a cadeia de caracteres do valor a ser formatada for "56M" em Euros, a cadeia de caracteres formatada retornada será de 56M de Euros. Nota: A mesma cadeia de caracteres de formato é usada sempre que o método format() é chamado neste objeto.

Exemplo

var formatString = '%s%v%c';
var exchangeValue = new sn_currency.GlideCurrencyFormatter(formatString);

GlideCurrencyFormatter com escopo - format(cadeia de caracteres "value", cadeia de caracteres "currencyCode")

Formata um valor de moeda especificado usando o código de moeda especificado.

O formato resultante da moeda também depende dos valores passados quando o objeto GlideCurrencyFormatter foi instanciado pela primeira vez.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
valor	Cadeia de caracteres	Valor da moeda a ser formatado. O valor só pode conter um ponto decimal para denotar o valor fracionário, vírgulas não são compatíveis. Valores válidos: 123,45 ou 2436,23 Valores inválidos 123,45 ou 2.134,56
currencyCode	Cadeia de caracteres	Código de moeda ISO de três letras a ser usado na formatação da moeda.

Tabela 3. Retorna

Tipo	Descrição
Cadeia de caracteres	Valor de moeda formatado.

Exemplo

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));

Saída:

Formatted currency: $123,456.12USD

GlideCurrencyFormatter com escopo - setLocale(cadeia de caracteres idioma, cadeia de caracteres país)

Define o idioma e o país padrão, que constituem a localidade, para o formatador de moeda.

Se você não chamar este método antes de chamar o método GlideCurrencyFormatter.format(), a localidade será padronizada para a localidade da sessão atual.

Tabela 4. Parâmetros

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

Tabela 5. Retorna

Tipo	Descrição
vazio

Este exemplo mostra a configuração do formatador de moeda para a França.

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));

Saída:

Formatted currency: €123 456,12EUR

GlideCurrencyFormatter com escopo - setMaxFractionDigits(Number maxFractionDigits)

Define o número máximo de dígitos a serem retornados à direita da vírgula decimal/vírgula decimal.

Tabela 6. Parâmetros

Nome	Tipo	Descrição
maxFractionDigits	Número	Número máximo de dígitos de frações a serem retornados. Se este valor for definido como algo menor que o valor minFractionDigits, ele será substituído por minFractionDigits.

Tabela 7. Retorna

Tipo	Descrição
vazio

Exemplo

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));

Saída:

Formatted currency: $123,456.12USD

GlideCurrencyFormatter com escopo - setMinFractionDigits(Number minFractionDigits)

Define o número mínimo de dígitos de frações (à direita do ponto decimal/vírgula decimal) a serem retornados.

Tabela 8. Parâmetros

Nome	Tipo	Descrição
minFractionDigits	Número	Número mínimo de dígitos de frações a serem retornados.

Tabela 9. Retorna

Tipo	Descrição
vazio

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));

Saída:

Formatted currency: $123,456.120USD