GlideCurrencyConverter - Com escopo

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura

    • . GlideCurrencyConverter A API fornece métodos para converter um valor de moeda em outro, como converter dólares americanos em euros europeus.

    Você pode instanciar o objeto GlideCurrencyConverter e definir as moedas de origem e de destino durante a instanciação usando GlideCurrencyConverter(de, para) . Você também pode instanciar o objeto sem esses valores e defini-los posteriormente usando SetFromCurrency() e. SetToCurrency() métodos. Esses valores e o valor a ser convertido devem ser definidos antes de chamar o. converter() método para executar a conversão de moeda. Para definir o valor a ser convertido, use SetAmount() método.

    . GlideCurrencyConverter A API também fornece métodos opcionais que permitem:
    • Definir a data e a hora para as quais a conversão será executada, SetDateTime() . Ao definir a data e a hora, a taxa usada no cálculo de conversão é a da data e hora especificadas, em vez do padrão da data e hora atuais.
    • Definir a tabela de taxas a ser usada na conversão, SetRateTable() . Por padrão, a conversão usa a tabela fx_system_rate. No entanto, você pode definir tabelas de taxas personalizadas para sua instância. Para obter informações adicionais sobre como criar tabelas de taxas, consulte Adicione taxas de conversão usando uma tabela de taxas personalizada .

    Esta API é fornecida no sn_currency namespace.

    GlideCurrencyConverter - GlideCurrencyConverter()

    Instancia um GlideCurrencyConverter objeto.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum(a)

    Este exemplo mostra como chamar o método.

    var conv = new sn_currency.GlideCurrencyConverter();

    GlideCurrencyConverter - GlideCurrencyConverter(cadeia de caracteres de, cadeia de caracteres para)

    Instancia um GlideCurrencyConverter e define os códigos do país de origem e de destino a serem usados na conversão de moeda.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    de Cadeia de caracteres Código do país ISO 3166 de três letras da moeda de origem.
    para Cadeia de caracteres Código do país ISO 3166 de três letras da moeda convertida.

    Este exemplo mostra como chamar o método.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');

    GlideCurrencyConverter - convert()

    Executa o conversor de moeda.

    Chame este método depois de chamar outro GlideCurrencyConverter métodos que constroem a conversão de moeda, como SetAmount() , SetRateTable() e SetDate() .

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 4. Retorna
    Tipo Descrição
    GlideCurrencyExchangeValue objeto GlideCurrencyExchangeValue objeto que contém detalhes sobre a conversão.
    CurrencyExchangeValue{
  fAmount: Number,
  fCurrency: "String",
  fOriginalAmount: Number,
  fOriginalCurrency: "String",
  fRate: Number,
  fRateSysId: "String"
}
    CurrencyExchangeValue.fAmount Valor convertido ( fOriginalAmount* fRate).

    Tipo de dados: Número
    CurrencyExchangeValue.fCurrencyCurrency Código da moeda alfabética ISO 4217 para a moeda convertida.

    Tipo de dados: Cadeia de caracteres
    CurrencyExchangeValue.fOriginalAmount Valor da moeda original.

    Tipo de dados: Número
    CurrencyExchangeValue.fMoeda original Código da moeda alfabética ISO 4217 para a moeda original.

    Tipo de dados: Cadeia de caracteres
    CurrencyExchangeValue.Frate Taxa de câmbio usada na conversão.

    Tipo de dados: Número
    CurrencyExchangeValue.fRateSysId Sys_id da taxa de câmbio usada na conversão.

    Tabela: Taxa de conversão de moeda [fx_conversion_rate]

    Tipo de dados: Cadeia de caracteres

    Este exemplo mostra como chamar o método.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
conv.setAmount(100);
gs.info(conv.convert());

    Saída:

    CurrencyExchangeValue{fOriginalAmount=100, fOriginalCurrency='EUR', fRate=1.1604, fAmount=116.04, fCurrency='USD', fRateSysId='4555525f5553445f3230323530383036'}

    GlideCurrencyConverter - setAmount(valor da cadeia de caracteres)

    Define a quantidade de moeda a ser convertida.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    valor Cadeia de caracteres Valor da moeda a ser convertido. Este valor não deve ser formatado, exceto por uma vírgula decimal para denotar moeda fracionária. Por exemplo, 1234,56 é válido, 1,234.56 é inválido.
    Tabela 6. Retornos
    Tipo Descrição
    vazio

    Este exemplo mostra como chamar o método.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
conv.setAmount(100);

    GlideCurrencyConverter - setDateTime(Data do objeto)

    Define a data e a hora da conversão da moeda.

    Esta data e hora determinam a taxa de conversão usada para converter a moeda. Se este método não for chamado antes de GlideCurrencyConverter.convert() , a conversão é realizada usando a taxa da data/hora atual.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    data GlideDateTime Data/hora para a qual calcular a conversão de moeda. Este valor determina a taxa que é usada na conversão.
    Tabela 8. Retornos
    Tipo Descrição
    vazio

    O exemplo a seguir mostra como chamar este método.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
conv.setAmount(100);
var gd = new GlideDateTime("2019-01-03 11:00:00");
conv.setDateTime(gd);
gs.info(conv.convert());

    Saída:

    CurrencyExchangeValue{fOriginalAmount=100, fOriginalCurrency='EUR', fRate=1.061, fAmount=106.1, fCurrency='USD', fRateSysId='4555525f5553445f3130303030313031'}

    GlideCurrencyConverter - setFromCurrency(cadeia de caracteres de)

    Define o código do país da moeda de origem.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    de Cadeia de caracteres Código do país ISO 3166 de três letras da moeda de origem.
    Tabela 10. Retornos
    Tipo Descrição
    vazio

    Este exemplo mostra como chamar o método.

    var conv = new sn_currency.GlideCurrencyConverter().setFromCurrency('FRA');

    GlideCurrencyConverter - setRateTable(cadeia de caracteres rateTable)

    Define a tabela de taxas a ser usada na conversão de moeda.

    Se este método não for chamado antes de GlideCurrencyConverter.convert() o método é chamado, a conversão é realizada usando a tabela fx_system_rate. Todas as tabelas de taxas personalizadas devem estender a tabela fx_conversion_rate. Para obter informações adicionais sobre como criar tabelas de taxas, consulte Adicione taxas de conversão usando uma tabela de taxas personalizada .

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    Tabela de taxação Cadeia de caracteres Nome da tabela de taxas a ser usada na conversão de moeda.
    Tabela 12. Retornos
    Tipo Descrição
    vazio

    Este exemplo mostra como chamar o método.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
conv.setRateTable(custom_rate_table);

    GlideCurrencyConverter - setToCurrency(cadeia de caracteres para)

    Define o código do país da moeda de destino.

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    para Cadeia de caracteres Código do país ISO 3166 de três letras da moeda de origem.
    Tabela 14. Retornos
    Tipo Descrição
    vazio

    Este exemplo mostra como chamar o método.

    var conv = new sn_currency.GlideCurrencyConverter().setToCurrency('USA');