GlideCurrencyParser : inclus dans le champ d’application

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture

    • L’API GlideCurrencyParser fournit des méthodes pour analyser les valeurs de devises FX afin de 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 en 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 non formaté.

    Cette classe s’exécute 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 : analyser (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é par un point-virgule). Si le code de devise n’est pas défini avant d’appeler la méthode parse(), le code de devise de la session en cours est attribué par défaut.

    Cette méthode prend en charge à la fois la virgule 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 (en anglais seulement) Informations sur la valeur analysée.

    Type de données : objet

    Dans cet exemple, le paramètre régional est défini sur France, puis la valeur de la devise transmise est convertie 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

    Dans cet exemple, le code de devise par défaut est défini sur Dollars américains, 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 comme valeur 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(langue de la chaîne, pays de la chaîne)

    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