Valores de moeda padrão em scripts
Você pode usar campos de moeda em scripts.
Esses métodos estão disponíveis em objetos GlideElement.
Para exibir valores de moeda, use a API de exibição getDisplayValue(). Para trabalhar com valores de moeda de qualquer forma diferente de exibição, use as APIs que retornam/aceitam números não formatados.
Nota:
Antes de executar cálculos no valor, não use os métodos getDisplayValue () e processe a cadeia de caracteres para remover informações de formatação.
Métodos como getValue() e getCurrencyValue() retornam números não formatados como cadeias de caracteres. Para obter o valor de ponto flutuante, use a função JavaScript parseFloat()e, em seguida, use o valor resultante para executar cálculos. Para obter a moeda associada a esses valores, use as APIs que retornam o código da moeda. Você também pode usar os métodos getCurrencyCode() para determinar a moeda de um campo.
var rate = parseFloat(current.base_rate);
var currencyCode = current.base_rate.getCurrencyCode();
Use o método setValue() para definir o valor de um campo de moeda. Se esta moeda for a moeda da sessão do usuário, use um número simples ou o número de ponto flutuante de uma cadeia de caracteres que o contenha. Caso contrário, prefixe o valor com o código de moeda ISO de 3 letras.
var totalCost = rate*current.hourly_rate;
current.total_cost.setValue(currencyCode + ";" + totalCost);
Você está trabalhando com o valor da moeda de referência ao usar o GlideAggregate em campos de moeda ou preço. Certifique-se de converter os valores agregados para a moeda da sessão do usuário para exibição. O valor resultante pode não ser o esperado. A taxa de conversão usada para o valor do campo de moeda ou preço e para sua moeda de referência, que é usada para a agregação, pode ter sido alterada.
Quando você exclui um registro que contém um valor de moeda, a plataforma exclui todos os registros de moeda associados.
Nota:
Não use deleteMultiple() em tabelas com campos de moeda. Sempre exclua cada registro individualmente.
Os valores de moeda contêm quatro casas decimais.
- APIs que retornam valores como getValue() retornam até quatro casas decimais. Os zeros à direita são sempre removidos.
- As APIs que retornam valores de exibição, como getDisplayValue(), têm pelo menos duas casas decimais e até quatro casas decimais.
- O GlideAggregate retorna quatro casas decimais.
Você pode fazer com que o sistema use duas casas decimais. Quando você o define com duas casas decimais, os valores numéricos retornados pela API contêm duas casas decimais. Embora as taxas de conversão de moeda possam ter mais casas decimais, os campos de moeda armazenam apenas duas casas decimais. APIs que aceitam valores numéricos que arredondam casas decimais para duas casas.
- APIs que retornam valores como getValue() retornam até duas casas decimais. Os zeros à direita são removidos para valores lidos do banco de dados, mas se um valor como 00 for definido posteriormente, 1,00 poderá ser retornado. O número de zeros à direita retornados não é consistente.
- As APIs que retornam valores de exibição, como getDisplayValue(), contêm até duas casas decimais. Às vezes, ele pode retornar duas casas, mesmo para valores como 7,10, mas pode remover zeros à direita em outros momentos. O número de zeros à direita retornados não é consistente.
- O GlideAggregate retorna duas casas decimais.
Nota:
Para saber como alterar o número de casas decimais usadas pelo sistema, consulte Alterar casas decimais da moeda padrão.
No exemplo a seguir, a localidade do usuário é definida como Alemão (de.DE) e a moeda de referência definida como USD. Os valores usam um valor de moeda de 21345,67 em ienos, 1563,72 em euros e 1152,48 em dólares americanos.
| Nome do método | Descrição | Exemplo |
|---|---|---|
| obterValor() | Retorna o valor da moeda na moeda da sessão do usuário como um número não formatado. | 1563,72 |
| getReferenceValue() | Retorna o valor da moeda na moeda de referência como um número não formatado. | 1152,48 |
| getSessionValue() | Retorna o valor da moeda na moeda da sessão do usuário como e número não formatado. | 1563,72 |
| getCurrencyValue() | Retorna o valor da moeda conforme inserido como um número não formatado. | 21345,67 |
| getDisplayValue() | Retorna o valor da moeda na moeda da sessão do usuário, formatado na localidade do usuário com um símbolo de moeda. | 1.563,72 € |
| getSessionDisplayValue() | Retorna o valor da moeda na moeda da sessão do usuário, formatado na localidade do usuário com um símbolo de moeda. | 1.563,72 € |
| getReferenceDisplayValue() | Retorna o valor da moeda na moeda de referência, formatada na localidade do usuário com um símbolo de moeda. | US$ 1.152,48 |
| getCurrencyDisplayValue() | Retorna o valor da moeda conforme inserido, formatado na localidade do usuário com um símbolo de moeda. | 21.345,67 |
| getCurrencyString() | Retorna o valor da moeda conforme inserido como um número não formatado, prefixado pelo código de moeda ISO de três letras, separado por ponto e vírgula. | JPY 21345,67 |
| getCurrencyCode() | Retorna o código de moeda ISO de 3 letras para o valor da moeda conforme inserido. | JPY |
| getSessionCurrencyCode() | Retorna o código de moeda ISO de três letras da moeda da sessão do usuário. | EUR |
| getReferenceCurrencyCode() | Retorna o código de moeda ISO de 3 letras da moeda de referência. | USD |
| definirValor() | Define o valor da moeda como:
|
4369.21 ou JPY 4369.21 |
| definirDisplayValue() | Define o valor da moeda como:
|
4369.21 ou JPY 4369.21 |