GlideCurrencyParser : champ d’application

L’API GlideCurrencyParser fournit des méthodes permettant d’analyser les valeurs de devises FX pour détecter la mise en forme basée sur les paramètres régionaux.

Les méthodes de cette classe analysent une chaîne spécifiée dans un objet GlideCurrencyValue, ce qui vous permet d’obtenir un formatage de devise basé sur les paramètres régionaux. Avant d’appeler la méthode GlideCurrencyParser.parse(), qui effectue réellement l’analyse, vous devez définir le code de devise à utiliser pendant l’analyse. Vous pouvez définir le code de devise en le transmettant dans l’appel de méthode GlideCurrencyParser.parse() ou en appelant GlideCurrencyParser.setDefaultCurrencyCode().

La définition des paramètres régionaux est facultative. Si vous ne le définissez pas via la méthode GlideCurrencyParser.setLocale(), le montant de la devise passé dans GlideCurrencyParser.parse() doit être déformaté.

Cette classe s’exécute dans l’espace de noms sn_currency .

GlideCurrencyParser inclus dans le champ d’application : GlideCurrencyParser()

Instancie un objet GlideCurrencyParser qui fournit des méthodes pour analyser une chaîne dans un objet GlideCurrencyValue.

Tableau 1. Paramètres

Nom	Type	Description
Néant

Exemple

var parser = new sn_currency.GlideCurrencyParser();

GlideCurrencyParser inclus dans le périmètre : parse(valeur de chaîne)

Analyse une chaîne spécifiée dans un objet GlideCurrencyValue pour obtenir un formatage de devise basé sur les paramètres régionaux.

Tableau 2. Paramètres

Nom	Type	Description
valide	Chaîne	Chaîne à analyser. Vous pouvez ajouter à cette chaîne le code de devise ISO à utiliser lors de l’analyse de celle-ci (séparés par des points-virgules). Si le code de devise n’est pas défini avant d’appeler la méthode parse(), la valeur par défaut est le code de devise de la session en cours. Cette méthode prend en charge à la fois la notation décimale et la virgule décimale. Par exemple : « 123,45 », « USD ; 123,45 », « 123,45 », « EUR ; 123,45 pouces

Tableau 3. Renvoie

Type	Description
GlideCurrencyValue	Informations sur la valeur analysée. Type de données : objet

Cet exemple définit les paramètres régionaux sur France, puis analyse la valeur de devise transmise en dollars américains.

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

Sortie :

USD;1234.56

Cet exemple définit le code de devise par défaut sur Dollars américains, puis analyse la valeur de devise.

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

Sortie :

USD;1234.56

GlideCurrencyParser inclus dans le périmètre : setDefaultCurrencyCode(String currencyCode)

Définit le code de devise de l’objet GlideCurrencyParser associé.

Tableau 4. Paramètres

Nom	Type	Description
currencyCode	Chaîne	Code de devise ISO à trois lettres à utiliser par défaut dans l’objet GlideCurrencyParser associé.

Tableau 5. Renvoie

Type	Description
nul

Dans l’exemple suivant, le code de devise par défaut est défini sur Dollars américains.

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

Sortie :

USD;123.45

GlideCurrencyParser inclus dans le champ d’application : setLocale(String language, String country)

Définit les codes de langue et de pays par défaut, qui constituent les paramètres régionaux, sur l’objet GlideCurrencyParser associé.

Si vous n’appelez pas cette méthode avant d’appeler la méthode GlideCurrencyParser.parse(), les paramètres régionaux sont par défaut les paramètres régionaux de la session actuelle.

Tableau 6. Paramètres

Nom	Type	Description
langue	Chaîne	Code de langue ISO 639 à deux lettres, tel que en, es et fr.
pays	Chaîne	Code pays ISO 3166 à deux lettres, par exemple US, ES et FR.

Tableau 7. Renvoie

Type	Description
nul

L’exemple suivant montre comment définir les paramètres régionaux sur Espagne.

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

Sortie :

USD;1234.56