GlideCurrencyParser : dans l’étendue

L’API GlideCurrencyParser fournit des méthodes pour analyser les valeurs de devises FX afin de détecter le formatage basé 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 devise transmis dans GlideCurrencyParser.parse() doit être annulé.

Cette API est fournie dans l’espace de noms sn_currency .

GlideCurrencyParser : GlideCurrencyParser()

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

Tableau 1. Paramètres

Nom	Type	Description
Aucun

Cet exemple montre comment appeler la méthode.

var parser = new sn_currency.GlideCurrencyParser();

GlideCurrencyParser : 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 la chaîne (séparée par des points-virgules). Si le code de devise n’est pas défini avant d’appeler la méthode parse( ), il utilise par défaut le code de devise de la session en cours. Cette méthode prend en charge la notation par virgules décimales et décimales. Par exemple : « 123,45 », « USD ; 123,45 », « 123,45 », « EUR ; 123,45"

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 la 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 le dollar américain, puis analyse la valeur de la 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 : setDefaultCurrencyCode(String currencyCode)

Définit le code de devise pour 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

L’exemple suivant définit le code de devise par défaut sur le dollar américain.

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 : 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 définis par défaut sur les paramètres régionaux de la session en cours.

Tableau 6. Paramètres

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

Tableau 7. Renvoie

Type	Description
nul

L’exemple suivant montre comment définir les paramètres régionaux sur l’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