GlideCurrencyExchangeValue - com escopo

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 1 min. de leitura
  • A API GlideCurrencyExchangeValue fornece métodos para acessar informações relacionadas a conversões de moeda FX.

    Consulte a API GlideCurrencyConverter() para métodos que retornam um objeto GlideCurrencyExchangeValue.

    Esta classe é executada no namespace sn_currency.

    Nota:
    Não há nenhum construtor para esta classe.

    GlideCurrencyExchangeValue – getAmount()

    Retorna o valor da moeda após a conversão.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 2. Retorna
    Tipo Descrição
    Número Valor da moeda após a conversão.

    Este exemplo pressupõe uma taxa de conversão de 1 Euro = 0,92 Dólar americano.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
    conv.setAmount(100);
    var convertValues = conv.convert();
    gs.info('Exchanged Amount: ' + convertValues.getAmount());

    Saída:

    Exchanged Amount: $92.00

    GlideCurrencyExchangeValue – getCurrency()

    Retorna o convertido para o tipo de moeda.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 4. Retorna
    Tipo Descrição
    Cadeia de caracteres Código de moeda ISO de três letras do convertido para a moeda.

    Este exemplo mostra como chamar o método.

    var convertValues = new sn_currency.GlideCurrencyConverter('USD', 'JPY');
    convertValues.setAmount(100);
    gs.info('Exchanged Currency (To): ' + convertValues.convert().getCurrency());

    Saída:

    Exchanged Currency (To): JPY

    GlideCurrancyExchangeValue - getOriginalCurrency()

    Retorna o tipo de moeda original de pré-conversão.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 6. Retorna
    Tipo Descrição
    Cadeia de caracteres Código de moeda ISO de três letras da moeda convertida.

    Este exemplo mostra como chamar o método.

    var converter = new sn_currency.GlideCurrencyConverter('USD', 'JPY');
    converter.setAmount(999.999)
    var convertValues = converter.convert();
    gs.info('Original Amount: ' + convertValues.getOriginalCurrency());

    Saída:

    Original Amount: USD

    GlideCurrencyExchangeValue - getOriginalValue()

    Retorna o valor original de pré-conversão.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 8. Retorna
    Tipo Descrição
    Número Valor original antes da conversão.

    Este exemplo mostra como chamar o método.

    var converter = new sn_currency.GlideCurrencyConverter('USD', 'JPY');
    converter.setAmount(999.999)
    var convertValues = converter.convert();
    gs.info('Original Amount: ' + 'convertValues.getOriginalAmount());
    

    Saída:

    Original Amount: 999.999

    GlideCurrencyExchangeValue – getRate()

    Retorna a taxa de câmbio usada durante a conversão.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 10. Retorna
    Tipo Descrição
    Número Taxa de câmbio usada na conversão de moeda.

    Este exemplo mostra como chamar o método.

    var converter = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
    converter.setAmount(999.999)
    var convertValues = converter.convert();
    gs.info('Original Amount: ' + convertValues.getRate());

    Saída:

    Exchange rate: 1.0559

    GlideCurrencyExchangeValue – getRateSysId()

    Retorna o sys_id do registro na tabela de taxas usada na conversão de moeda.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 12. Retorna
    Tipo Descrição
    Cadeia de caracteres Sys_id da tabela de taxas usada na conversão de moeda.

    Este exemplo mostra como chamar o método.

    var converter = new sn_currency.GlideCurrencyConverter('USD', 'JPY');
    converter.setAmount(999.999)
    var convertValues = converter.convert();
    gs.info('Rate table sys_id: ' + convertValues.getRateSysId());

    Saída:

    Original Amount: 99ebb4156fa831005be8883e6b3ee4b9