GlideCurrencyFormatter - Com escopo

. GlideCurrencyFormatter A API 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. Uma vez definido, o mesmo formato é usado sempre que você chama o. GlideCurrencyFormatter.format() método desse objeto. . GlideCurrencyFormatter() e. formato () Os métodos são os dois únicos métodos que você deve chamar para formatar Moeda FX.

. GlideCurrencyFormatter() A API 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 uma vírgula decimal ou vírgula decimal é usada para denotar frações do valor da moeda. Padrão: Localidade do sistema
• Defina o número mínimo de dígitos fracionais a serem exibidos usando SetMinFractionDigits() . Define o número mínimo de dígitos à direita da vírgula decimal/decimal a ser incluído. Por padrão, todos os dígitos passados são exibidos. Se o valor aprovado 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 fracionais a serem exibidos usando MaxFractionDigits() . Define o número máximo de dígitos à direita da vírgula decimal/decimal a ser incluído. Por padrão, todos os dígitos passados são exibidos. Se o valor aprovado 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 de dígitos de fração máxima. O arredondamento é realizado para o dígito mais próximo à direita. Por exemplo, se o dígito da fração máxima estiver definido como 2 e o valor da moeda passada 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 está em sn_currency namespace.

GlideCurrencyFormatter - GlideCurrencyFormatter(cadeia de caracteres formatString)

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

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

Tabela 1. Parâmetros

Nome	Tipo	Descrição
FormatString	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 de moeda associado ao código do país especificado em formato () chamada. %v: Substituído pelo valor da moeda, como 123,45. %C: Substituído pelo código de moeda ISO especificado em formato () Chamada, 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 USD. Se a cadeia de caracteres de formato for '%s%l%c' e a cadeia de caracteres de valor a ser formatada for '56 M' em euros, a cadeia de caracteres formatada retornada será 56 M EUR Nota: A mesma cadeia de caracteres de formato é usada sempre que formato () o método é chamado neste objeto.

Este exemplo mostra como chamar o método.

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

GlideCurrencyFormatter - format(Valor da cadeia de caracteres, 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 inicialmente.

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 indicar 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 ao formatar a moeda.

Tabela 3. Retornos

Tipo	Descrição
Cadeia de caracteres	Valor da moeda formatada.

Este exemplo mostra como chamar o método.

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 - setlocale(idioma da cadeia de caracteres, país da cadeia de caracteres)

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

Se você não chamar este método antes de chamar GlideCurrencyFormatter.format() o padrão da localidade é 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. Retornos

Tipo	Descrição
vazio

Este exemplo mostra a configuração do formatador de moeda como 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 - setMaxFractionDigits(Number maxFractionDigits)

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

Tabela 6. Parâmetros

Nome	Tipo	Descrição
MaxFractionDigits	Número	Número máximo de dígitos de fração a serem retornados. Se este valor estiver definido como algo menor que minFractionDigitsvalor, ele é substituído por minFractionDigits.

Tabela 7. Retornos

Tipo	Descrição
vazio

Este exemplo mostra como chamar o método.

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 - setMinFractionDigits(Number minFractionDigits)

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

Tabela 8. Parâmetros

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

Tabela 9. Retornos

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