---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideCurrencyParser - com escopo

# GlideCurrencyParser - com escopo {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

A API GlideCurrencyParser fornece métodos para analisar valores de moeda de FX para detectar formatação baseada em localidade.

Os métodos nesta classe analisam uma cadeia de caracteres especificada em um objeto [GlideCurrencyValue](https://servicenow-prod.fluidtopics.net/ACzXpxtMQgGqAXyOeNSS6A#GlideCurrencyValueScopedAPI "A API GlideCurrencyValue fornece métodos que retornam o código da moeda e a moeda original de uma chamada GlideCurrencyParser.parse() associada."), permitindo que você obtenha a formatação de moeda com base na localidade. Antes de chamar o método GlideCurrencyParser.parse(), que realmente executa a análise, você deve definir o código da moeda a ser usado durante a análise. Você pode definir o código da moeda passando-o na chamada do método GlideCurrencyParser.parse() ou chamando GlideCurrencyParser.setDefaultCurrencyCode().

Definir a localidade é opcional. Se você não definir por meio do método GlideCurrencyParser.setLocale(), o valor da moeda passado para GlideCurrencyParser.parse() deverá ser desformatado.

Esta classe é executada no namespace `sn_currency`.

## GlideCurrencyParser - GlideCurrencyParser() {#ariaid-title2}

Instancia um objeto GlideCurrencyParser que fornece métodos para analisar uma cadeia de caracteres em um objeto GlideCurrencyValue.
{#GCPS-GlideCurrencyParser__table_s5m_rh2_4jb__entry__3}

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

{#GCPS-GlideCurrencyParser__table_s5m_rh2_4jb}  
Este exemplo mostra como chamar o método.

    var parser = new sn_currency.GlideCurrencyParser();

## GlideCurrencyParser - analisar (valor da cadeia de caracteres) {#ariaid-title3}

Analisa uma cadeia de caracteres especificada em um objeto GlideCurrencyValue para obter a formatação de moeda com base na localidade.
{#GCPS-parse_S__table_wpy_532_4jb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| valor | Cadeia de caracteres | Cadeia de caracteres a ser analisada. Você pode prefixar esta cadeia de caracteres com o código de moeda ISO a ser usado ao analisar a cadeia de caracteres (separados por ponto e vírgula). Se o código da moeda não for definido antes de chamar o método parse(), o padrão será o código da moeda da sessão atual. Este método oferece suporte à notação de ponto decimal e vírgula decimal. Por exemplo: "123,45", "USD;123,45", "123,45", "Euro;123,45" |
[Tabela 2. Parâmetros]

{#GCPS-parse_S__table_wpy_532_4jb} {#GCPS-parse_S__table_xpy_532_4jb__entry__2}

| Tipo | Descrição |
|-|-|
| GlideCurrencyValue | Informações de valor analisadas. Tipo de dados: objeto |
[Tabela 3. Retorna]

{#GCPS-parse_S__table_xpy_532_4jb}  
Este exemplo define a localidade como França e analisa o valor da moeda passado para dólares norte-americanos.

    var gp = new sn_currency.GlideCurrencyParser();
    gp.setLocale("fr", "FR");
    var cv = gp.parse("USD;1234,56");
    gs.info(cv);

Saída:

    USD;1234.56

Este exemplo define o código da moeda padrão como dólares norte-americanos e analisa o valor da moeda.

    var amount = "1234.56"
    var gp = new sn_currency.GlideCurrencyParser();
    gp.setDefaultCurrencyCode("USD");
    var cv = gp.parse(amount);
    gs.info(cv);

Saída:

    USD;1234.56

## GlideCurrencyParser - setDefaultCurrencyCode(cadeia de caracteres currencyCode) {#ariaid-title4}

Define o código da moeda para o objeto GlideCurrencyParser associado.
{#GCPS-setDefaultCurrencyCode_S__table_tww_5zz_4jb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| currencyCode | Cadeia de caracteres | Código de moeda ISO de três letras a ser usado como padrão no objeto GlideCurrencyParser associado. |
[Tabela 4. Parâmetros]

{#GCPS-setDefaultCurrencyCode_S__table_tww_5zz_4jb} {#GCPS-setDefaultCurrencyCode_S__table_uww_5zz_4jb__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 5. Retorna]

{#GCPS-setDefaultCurrencyCode_S__table_uww_5zz_4jb}  
O exemplo a seguir define o código da moeda padrão como dólares norte-americanos.

    var amount = "123.45"
    var gp = new sn_currency.GlideCurrencyParser();
    gp.setDefaultCurrencyCode("USD");
    var cv = gp.parse(amount);
    gs.info(cv);

Saída:

    USD;123.45

## GlideCurrencyParser - setLocale(cadeia de caracteres idioma, cadeia de caracteres país) {#ariaid-title5}

Define o idioma padrão e os códigos de país, que constituem a localidade, no objeto GlideCurrencyParser associado.
Se você não chamar este método antes de chamar o método GlideCurrencyParser.parse(), a localidade padrão será a localidade da sessão atual.
{#GCPS-setLocale_S_S__table_e1j_shz_4jb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| idioma | Cadeia de caracteres | Código de idioma ISO 639 de duas letras, como en, es e fr. |
| país | Cadeia de caracteres | Código de país ISO 3166 de duas letras, como US, ES e FR. |
[Tabela 6. Parâmetros]

{#GCPS-setLocale_S_S__table_e1j_shz_4jb} {#GCPS-setLocale_S_S__table_f1j_shz_4jb__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 7. Retorna]

{#GCPS-setLocale_S_S__table_f1j_shz_4jb}  
O exemplo a seguir mostra como definir a localidade como "Espanha".

    var amount = "USD;1.234,56"
    var gp = new sn_currency.GlideCurrencyParser();
    gp.setLocale("es", "ES");
    var cv = gp.parse(amount);
    gs.info(cv);

Saída:

    USD;1234.56