Fonctions d’exécution de conversion X++

Remarque

Les groupes d’intérêt communautaire sont désormais passés de Yammer à Microsoft Viva Engage. Pour rejoindre une communauté Viva Engage et participer aux dernières discussions, remplissez le formulaire Demande d’accès à la Finance et Opérations Viva Engage Communauté et choisissez la communauté que vous souhaitez rejoindre.

Cet article décrit les fonctions d’exécution de conversion.

any2Date

Convertit une valeur anytype en valeur de date .

date any2Date(anytype object)

Paramètres

Paramètre	Description
objet	Valeur à convertir en date.

Valeur de retour

Valeur de date .

Remarques

Le paramètre objet peut être la plupart des types de données, mais vous obtenez une sortie utile quand il est de type str ou int . Un contenu inapproprié génère une erreur d’exécution.

Exemple

static void any2DateExample(Args _args)
{
    date myDate;
    str s;
    int i;
    s = "2010 6 17"; // A string object, of yyyy mm dd.
    myDate = any2Date(s);
    Global::info(strFmt("%1  is output, from input of "2010 6 17"", myDate));
    i = 40361; // An int object, which represents the number of days from 1900/01/01.
    myDate = any2Date(i);
    Global::info(strFmt("%1  is output, from input of 40361", myDate));
}
/**** Infolog display.
Message (04:44:15 pm)
6/17/2010 is output, from input of "2010 6 17"
7/4/2010 is output, from input of 40361
****/

any2Enum

Convertit une valeur anytype en valeur de propriété Name d’un élément dans l’énumération cible.

enum any2Enum(anytype object)

Paramètres

Paramètre	Description
objet	Valeur correspondant à la propriété Value d’un élément dans l’énumération cible.

Valeur de retour

Valeur de la propriété Name pour l’élément de l’énumération cible dont la propriété Value correspond au paramètre d’entrée.

Remarques

Le paramètre objet peut représenter la plupart des types de données, mais vous n’obtenez des données utiles que lorsque vous utilisez un paramètre du type str ou int . Ce paramètre d’objet d’entrée fait référence à la propriété Value d’un élément individuel dans l’énumération cible.

Exemple

static void any2EnumExample(Args _args)
{
    NoYes myNoYes;  // NoYes is an enum.
    int i;
    str s;
    i = 0;  // An int that will be converted.
    myNoYes = any2Enum(i);
    Global::info(strfmt("'%1' - is the output, from input of the %2 as int.", myNoYes, i));
    s = "1";  // A str that will be converted.
    myNoYes = any2Enum(s);
    Global::info(strfmt("'%1' - is the output, from input of the %2 as str.", myNoYes, s));
    /**** Infolog display.
    Message (01:05:32 pm)
    'No' - is the output, from input of the 0 as int.
    'Yes' - is the output, from input of the 1 as str.
    ****/
}

any2Guid

Convertit l’objet anytype spécifié en objet GUID.

guid any2Guid(anytype object)

Paramètres

Paramètre	Description
objet	Valeur à convertir en objet GUID.

Valeur de retour

Un objet GUID.

any2Int

Convertit une valeur anytype en valeur int .

int any2Int(anytype object)

Paramètres

Paramètre	Description
objet	Valeur à convertir.

Valeur de retour

Une valeur int .

Remarques

Le paramètre objet peut être la plupart des types de données, mais vous n’obtenez des données utiles que lorsque vous utilisez des paramètres du type enum, real ou str .

Exemple

static void any2IntExample(Args _args)
{
    int myInt;
    str s;
    NoYes a;
    real r;
    s = "31";
    myInt = any2Int(s);
    Global::info(strfmt("%1 is the output, from input of 31 as a str value.", myInt));
    a = NoYes::No;
    myInt = any2Int(a);
    Global::info(strfmt("%1 is the output, from input of NoYes::No as an enum value.", myInt));
    r = 5.34e2;
    myInt = any2Int(r);
    Global::info(strfmt("%1 is the output, from the input of 5.34e2 as a real value.", myInt));
}
/**** Infolog display.
Message (02:23:59 pm)
31 is the output, from input of 31 as a str value.
0 is the output, from input of NoYes::No as an enum value.
534 is the output, from the input of 5.34e2 as a real value.
****/

any2Int64

Convertit un objet anytype en objet int64 .

int64 any2Int64(anytype object)

Paramètres

Paramètre	Description
objet	Objet anytype à convertir.

Valeur de retour

Un objet int64 .

any2Real

Convertit une valeur anytype en valeur réelle .

real any2Real(anytype object)

Paramètres

Paramètre	Description
objet	Valeur à convertir.

Valeur de retour

Une vraie valeur.

Remarques

Le paramètre objet peut être la plupart des types de données, mais vous obtenez une sortie utile pour les éléments d’entrée des types date, int, enum et str .

Exemple

static void any2RealExample(Args _args)
{
    real myReal;
    str s;
    int i;
    NoYes a;
    s = "5.12";
    myReal = any2Real(s);
    Global::info(strfmt("%1 is the output from the input of 5.12 as a str object", myReal));
    i = 64;
    myReal = any2Real(i);
    Global::info(strfmt("%1 is the output from the input of 64 as an int object", myReal));
    a = NoYes::Yes;
    myReal = any2Real(a);
    Global::info(strfmt("%1 is the output from the input of NoYes::Yes as an enum object", myReal));
}
/****Infolog display.
Message (02:43:57 pm)
5.12 is the output from the input of 5.12 as a str object
64.00 is the output from the input of 64 as an int object
1.00 is the output from the input of NoYes::Yes as an enum object
****/

any2Str

Convertit une valeur anytype en valeur str .

str any2Str(anytype object)

Paramètres

Paramètre	Description
objet	Valeur à convertir.

Valeur de retour

Une valeur str .

Remarques

Le paramètre objet peut représenter la plupart des types de données, mais vous obtenez une sortie utile des éléments d’entrée des types date, int et enum .

Exemple

static void any2StrExample(Args _args)
{
    str myStr;
    anytype a;
    a = "Any to string";
    myStr = any2Str(a);
    Global::info(strFmt("%1 is output, from input of Any to string as a str value", myStr));
    a = NoYes::Yes;
    myStr = any2Str(a);
    Global::info(strFmt("%1 is output, from input of NoYes::Yes as an enumeration", myStr));
}
/****Infolog Display
Message (09:08:46 am)
Any to string is output, from input of Any to string as a str value
1 is output, from input of NoYes::Yes as an enumeration
****/

anytodate

Voir any2Date.

anytoenum

Voir any2Enum.

anytoguid

Voir any2Guid.

anytoint

Voir any2Int.

anytoint64

Voir any2Int64.

anytoreal

Voir any2Real.

anytostr

Voir any2Str.

char2Num

Convertit un caractère d’une chaîne en valeur ASCII du caractère.

int char2Num(str text, int position)

Paramètres

Paramètre	Description
SMS	Chaîne qui contient le caractère.
position	Position du caractère dans la chaîne.

Valeur de retour

Valeur ASCII du caractère en tant qu’objet int .

Remarques

char2Num("ABCDEFG",3); //Returns the numeric value of C, which is 67.
char2Num("ABCDEFG",1); //Returns the numeric value of A, which is 65.

date2Num

Convertit une date en un nombre entier qui correspond au nombre de jours écoulés depuis le 1er janvier 1900.

int date2Num(date _date)

Paramètres

Paramètre	Description
_date	La date à convertir.

Valeur de retour

Nombre de jours écoulés entre le 1er janvier 1900 et la date spécifiée.

Exemple

//Returns the value377.
date2Num(1311901);
static void date2NumExample(Args _arg)
{
    date d = today();
    int i;
    i = date2Num(d);
    print i;
}

date2Str

Convertit la date spécifiée en une chaîne.

str date2Str(date date, int sequence, int day, int separator1, int month, int separator2, int year [, int flags = DateFlags::None])

Paramètres

Paramètre	Description
date	La date à convertir.
séquence	Numéro à trois chiffres qui indique l’ordre des composantes de la date : 1 pour le jour, 2 pour le mois et 3 pour l’année.
jour	Valeur d’énumération qui indique le format de la composante jour de la date.
séparateur1	Valeur d’énumération qui indique le séparateur à utiliser entre les deux premiers composants de la date.
mois	Valeur d’énumération qui indique le format de la composante mois de la date.
séparateur2	Valeur d’énumération qui indique le séparateur à utiliser entre les deux derniers composants de la date.
année	Valeur d’énumération qui indique le format de la composante année de la date.
Drapeaux	Valeur d’énumération DateFlags qui indique si les paramètres de langue de l’ordinateur local doivent être utilisés pour calculer la séquence de gauche à droite ou de droite à gauche appropriée dans la chaîne renvoyée.

Valeur de retour

Chaîne qui représente la date spécifiée.

Remarques

MorphX alloue des valeurs valides aux paramètres de formatage si les valeurs spécifiées ne sont pas valides. Pour utiliser le format de date spécifié par l’utilisateur dans les paramètres régionaux, utilisez la fonction strFmt ou date2Str et spécifiez -1 dans tous les paramètres de formatage. Lorsque les paramètres régionaux contrôlent le format de date, les paramètres peuvent changer d’un utilisateur à l’autre. Si -1 est utilisé pour l’un ou l’autre des paramètres de séparateur , les deux séparateurs utilisent par défaut les paramètres régionaux. Les valeurs des paramètres de séquence doivent être un nombre à trois chiffres contenant exactement une occurrence des chiffres 1, 2 et 3. Les chiffres 1, 2 et 3 représentent respectivement le jour, le mois et l’année. Par exemple, 321 produit la séquence année, mois et jour. Ou la valeur peut être -1 pour utiliser les paramètres régionaux. N’utilisez pas de type d’énumération pour ce paramètre, car des nombres comme 321 dépassent la plage des valeurs valides pour les valeurs d’énumération, qui est de 0 à 250, inclus. La valeur par défaut du paramètre flags est la valeur d’énumération DateFlags ::None , ce qui signifie qu’aucun traitement de séquence de gauche à droite ou de droite à gauche n’est effectué.

Exemple

L’exemple suivant affiche la date du jour dans l’ordre de l’année, du mois et du jour.

static void Job2(Args _args)
{
    date currentDate = today();
    str s;
    int iEnum;
    s = date2Str
    (currentDate, 
        321,
        DateDay::Digits2,
        DateSeparator::Hyphen, // separator1
        DateMonth::Digits2,
        DateSeparator::Hyphen, // separator2
        DateYear::Digits4
    );
    info("Today is:  " + s);
}
/** Example Infolog output
Message (12:36:21 pm)
Today is:  2009-01-13
**/

datetime2Str

Convertit une valeur utcdatetime en une chaîne.

str datetime2Str(utcdatetime datetime [, int flags = DateFlags::None])

Paramètres

Paramètre	Description
DateHeure	Valeur utcdatetime à convertir.
Drapeaux	Valeur d’énumération DateFlags qui indique s’il faut utiliser les paramètres locaux pour la sortie de droite à gauche.

Valeur de retour

Une chaîne représentant la valeur utcdatetime que vous spécifiez comme paramètre datetime .

Remarques

Entrée date-heure nulle

Si vous spécifiez la valeur minimale utcdatetime pour le paramètre datetime , la fonction datetime2Str la traite comme une valeur d’entrée nulle. Cette valeur fait que la fonction retourne une chaîne vide. La méthode DateTimeUtil ::minValue renvoie la date-heure 1900-01-01T00:00:00. La fonction considère cette valeur minimale comme nulle.

Paramètres locaux de droite à gauche

Par défaut, cette fonction génère la chaîne dans une séquence gauche-droite, où la portion année est la plus à gauche. Cependant, si vous définissez le paramètre flags sur la valeur d’énumération DateFlags ::FormatAll , la fonction génère la chaîne dans une séquence droite-gauche lorsque les paramètres locaux sont configurés de droite à gauche. Les paramètres régionaux n’affectent pas le format de la méthode toStr de la classe DateTimeUtil .

Exemple

static void jobTestDatetime2str( Args _args )
{
    utcdatetime utc2 = 1959-06-17T15:44:33;
    str s3;
    s3 = datetime2Str( utc2 );
    info( s3 );
}

enum2Str

Convertit le texte énuméré spécifié en représentation de caractères.

str enum2Str(enum enum)

Paramètres

Paramètre	Description
énumération	Texte énuméré à convertir.

Valeur de retour

Valeur de l’énumération sous forme de chaîne.

Exemple

L’exemple suivant renvoie la chaîne « Non inclus ». Cette chaîne est l’étiquette de la valeur IncludeNot du type d’énumération ListCode .

static void enum2StrExample(Args _arg)
{
    ListCode l;
    l =  ListCode::IncludeNot;
    print enum2Str(l);
}

guid2Str

Convertit l’objet GUID spécifié en chaîne équivalente.

str guid2String(guid _uuid)

Paramètres

Paramètre	Description
_uuid	Objet GUID à convertir.

Valeur de retour

Équivalent de chaîne de l’objet GUID spécifié.

Exemple

static void guid2StrExample()
{
    guid _guid;
    str stringGuid;
    _guid = Global::guidFromString("{12345678-1234-1234-1234-123456789abc}");
    print strfmt("GUID is %1", _guid);
    stringGuid = guid2str(_guid);
    info("String GUID is " + stringGuid);
}
/**** Output to Infolog
String GUID is {12345678-1234-1234-1234-123456789ABC}
****/

int2Str

Convertit un entier en chaîne équivalente.

str int2Str(int integer)

Paramètres

Paramètre	Description
entier	Entier à convertir.

Valeur de retour

Représentation sous forme de chaîne de l’entier.

Exemple

static void int2StrExample(Args _arg)
{
    print "This is int2Str, value is " + int2Str(intMax());
    print "This is int642Str, value is " + int642Str(int64Max());
}

int642Str

Convertit le paramètre entier spécifié en chaîne de texte équivalente.

str int642Str(int64 integer)

Paramètres

Paramètre	Description
entier	L’int64 à convertir en chaîne de caractères.

Valeur de retour

Chaîne de texte équivalente du paramètre entier .

Exemple

static void example()
{
    print "This is int2Str, value is " + int2Str(intMax());
    print "This is int642Str, value is " + int642Str(int64Max());
}

num2Char

Convertit un entier en caractère ASCII correspondant.

str num2Char(int figure)

Paramètres

Paramètre	Description
figure	Entier à convertir en caractère.

Valeur de retour

Le caractère correspondant à l’entier spécifié.

Exemple

static void num2CharExample(Args _arg)
{
    str s;
    s = num2Char(42);
    // Prints an asterisk * -the character represented by 42.
    print s;
}

num2Date

Récupère la date qui correspond au nombre de jours spécifié après le 1er janvier 1900.

date num2Date(int _days)

Paramètres

Paramètre	Description
_Jours	Le nombre de jours après le 1er janvier 1900 pour renvoyer la date. Note: La première date valide est le 1er janvier 1901. Par conséquent, la fonction num2Date ne renvoie pas de date valide, sauf si _days est supérieure à 365.

Valeur de retour

La date correspond au nombre de jours spécifié par le paramètre _days après le 1er janvier 1900.

Remarques

num2Date(366); //Returns the date 01/01/1901 (1 January 1901).

num2Str

Convertit un nombre réel en une chaîne.

str num2Str(real number, int character, int decimals, int separator1, int separator2)

Paramètres

Paramètre	Description
nombre	Le nombre réel à convertir en chaîne.
personnage	Nombre minimal de caractères requis dans le texte.
Décimales	Nombre de décimales requis.
séparateur1	Valeur d’énumération DecimalSeparator .
séparateur2	Valeur d’énumération ThousandSeparator .

Valeur de retour

Chaîne qui représente le nombre.

Remarques

Pour le paramètre décimales , la valeur maximale est 16. Si vous utilisez un nombre plus grand, la méthode obtient une valeur pour le paramètre décimal provenant de l’ordinateur local à la place. Dans les deux cas, l’arrondissement se produit. Voici les valeurs d’énumération possibles pour le paramètre separator1 :

• 99 – Auto (les paramètres de formatage de l’utilisateur déterminent quel séparateur décimal est utilisé), valeur d’énumération DecimalSeparator ::Auto
• 1 – Point (.), valeur d’énumération DecimalSeparator ::D ot
• 2 – Virgule (,), valeur d’énumération DecimalSeparator ::Virgule

Voici les valeurs possibles pour le paramètre separator2 :

• 99 – Auto (les paramètres de formatage de l’utilisateur déterminent quel séparateur de milliers est utilisé)
• 0 – Aucun (pas de séparateur de milliers), valeur d’énumération ThousandSeparator ::Aucun
• 1 – Point (.), valeur d’énumération ThousandSeparator ::D ot
• 2 – Virgule (,), valeur d’énumération ThousandSeparator ::Virgule
• 3 – Apostrophe ('), valeur d’énumération ThousandSeparator ::Apostrophe
• 4 – Espace ( ), valeur d’énumération ThousandSeparator ::Space

Exemple

Dans l’exemple de code suivant, le premier appel à la méthode num2str fournit 16 pour le paramètre decimals , et le second appel fournit 17.

static void Job_Num2Str(Args _args)
{
    real realNum = 0.1294567890123456777; // 19 decimals places.
    info(Num2Str(realNum, 0, 16, DecimalSeparator::Dot, ThousandSeparator::Space)); // 16 decimal places
    info(Num2Str(realNum, 0, 17, DecimalSeparator::Dot, ThousandSeparator::Space)); // 17 decimal places
}

Sortie

Les messages se trouvent dans la sortie Infolog suivante. Le premier nombre de la sortie contient 16 décimales, tandis que le second nombre ne contient que deux décimales.

Message (10:18:12)
0.1294567890123457
0.13

str2Date

Convertit la chaîne spécifiée en valeur de date .

date str2Date(str _text, str _sequence)

Paramètres

Paramètre	Description
_SMS	Chaîne à convertir en valeur de date .
_séquence	Entier à trois chiffres qui décrit les positions du jour, du mois et de l’année dans la chaîne à convertir.

Valeur de retour

Valeur de date .

Remarques

Utilisez les valeurs suivantes pour spécifier les positions du jour, du mois et de l’année dans le paramètre _sequence :

• Jour : 1
• Mois : 2
• Année : 3

Par exemple, si la séquence de la chaîne est mois, année, puis jour, le paramètre _sequence doit être 231. Une date 0 (zéro) est renvoyée si les paramètres d’entrée spécifient une date non valide. Les deux exemples suivants spécifient une date non valide.

str2Date("31/12/44", 123) // Year must be four digits to reach the minimum of January 1 1901.
str2Date("31/12/2044", 213) // 213 means the month occurs first in the string, but 31 cannot be a month.

Exemple

static void str2DateExample(Args _arg)
{
    date d;
    d = str2Date("22/11/2007", 123);
    print d;
}

str2Datetime

Génère une valeur utcdatetime à partir de la chaîne spécifiée d’informations de date et d’heure.

utcdatetime str2datetime( str text, int sequence )

Paramètres

Paramètre	Description
SMS	Chaîne à convertir en valeur utcdatetime .
séquence	Numéro à trois chiffres qui décrit l’ordre des composants de date dans le paramètre de texte .

Valeur de retour

Valeur utcdatetime qui représente la date et l’heure spécifiées.

Remarques

Les exigences de syntaxe pour la partie date du paramètre de texte sont flexibles. La variété des formats valides est la même que dans la fonction date2str . Chacun des appels suivants à str2datetime est valide et produit tous le même résultat.

utc3 = str2datetime( "1985/02/25 23:04:59" ,321 );
utc3 = str2datetime( "Feb-1985-25 11:04:59 pm" ,231 );
utc3 = str2datetime( "2 25 1985 11:04:59 pm" ,123 );

Chaque composante de la date et de l’heure est représentée par un chiffre dans le paramètre de séquence :

• 1 – Jour
• 2 – Mois
• 3 – Année

Par exemple, l’ordre de l’année, du mois et du jour est 321. Toutes les valeurs valides contiennent chacun de ces trois chiffres exactement une fois. Si la valeur du paramètre de séquence n’est pas valide, les paramètres régionaux sont utilisés pour interpréter le paramètre de texte d’entrée. Si les paramètres d’entrée décrivent une date et une heure non valides, une chaîne vide est renvoyée.

Exemple

static void JobTestStr2datetime( Args _args )
{
    utcdatetime utc3;
    str sTemp;
    utc3 = str2datetime( "1985/02/25 23:04:59" ,321 );
    sTemp = datetime2str( utc3 );
    print( "sTemp == " + sTemp );
}

str2Enum

Récupère l’élément enumération pour lequel la valeur de la propriété Label localisée correspond à la chaîne d’entrée.

enum str2Enum(enum _type, str _text)

Paramètres

Paramètre	Description
_type	Une variable que vous déclarez comme type enum .
_SMS	Texte de propriété Label localisé de l’élément cible dans l’énumération.

Valeur de retour

Élément de l’énumération cible, qui représente également un int.

Remarques

La fonction associée enum2str renvoie la valeur d’une propriété Label à partir d’un élément de l’énumération. La valeur que la fonction enum2str retourne peut être l’entrée du paramètre _type de la fonction str2enum . Une valeur appropriée pour le paramètre _text est enum2Str(BankAccountType ::SavingsAccount). Chaque élément d’une énumération possède une propriété Name et une propriété Label . Dans une nouvelle installation , les valeurs Name sont presque toujours des mots anglais. Dans l’édition anglaise, la valeur de la propriété Label est presque toujours la même que la valeur Name . Toutefois, dans les éditions non anglaises, les valeurs Label sont localisées et ne correspondent donc pas aux valeurs Name.

Exemple

Pour éviter les incompatibilités de chaînes causées par la localisation vers d’autres langues parlées, utilisez la fonction enum2str pour générer l’entrée dans la fonction str2enum . L’exemple suivant montre la manière appropriée d’utiliser la fonction str2enum avec la fonction enum2str .

static void str2Enum_AcrossLangs(Args _arg)
{
    BankAccountType bat;
    str sEnumValueLabelLocalized;
    int nInt;
    // enum2str.
    sEnumValueLabelLocalized = enum2str(BankAccountType::SavingsAccount);
    info("Localized friendly string: "
        + sEnumValueLabelLocalized);
    // str2enum.
    bat = str2Enum(bat, sEnumValueLabelLocalized);
    nInt = bat;
    info("nInt = " + int2str(nInt));
    /********** Actual output:
    Message (04:32:12 pm)
    Localized friendly string: Savings account
    nInt = 1
    **********/
}

str2Guid

Convertit une chaîne en objet GUID.

Guid str2Guid(str text)

Paramètres

Paramètre	Description
Guid	Chaîne qui représente un GUID.

Valeur de retour

Un GUID que représente la chaîne d’entrée.

Remarques

Par exemple, une valeur valide pour le paramètre guid est {12345678-1234-abCD-3456-123456789012}, avec ou sans accolades.

str2Int

Convertit une chaîne en entier équivalent.

int str2Int(str _text)

Paramètres

Paramètre	Description
_SMS	Chaîne à convertir en entier.

Valeur de retour

Équivalent entier de la chaîne spécifiée.

Exemple

static void str2IntExample(Args _arg)
{
    int i;
    i = str2Int("1234567890");
    print "i = " + int2Str(i);
}

str2Int64

Convertit une chaîne en valeur Int64 .

int str2Int64(str text)

Paramètres

Paramètre	Description
SMS	Chaîne à convertir.

Valeur de retour

Valeur Int64 de la chaîne spécifiée.

Exemple

static void str2Int64Example(Args _args)
{
    str myStr;
    str tooBig;
    Int64 myInt64;
    myStr = "1234567890";
    tooBig = int642str(int64Max()+1);
    myInt64 = str2Int64(mystr);
    print strfmt ("int64: %1",myInt64);
    myInt64 = str2Int64(tooBig);
    print strfmt ("Too big int64: %1",myInt64);
}

str2Num

Convertit une chaîne en nombre réel.

real str2Num(str _text)

Paramètres

Paramètre	Description
_SMS	Chaîne à convertir en nombre réel.

Valeur de retour

Le nombre réel si la chaîne spécifiée contient un nombre valide ; sinon, 0 (zéro).

Remarques

Les exemples suivants montrent comment utiliser cette fonction.

str2Num("123.45") returns the value 123.45.
str2Num("a123") returns the value 0.0.
str2Num("123a") returns the value 123.00.

Le balayage s’effectue de gauche à droite et se termine lorsqu’un caractère ne peut pas être converti en partie d’un nombre réel.

Exemple

static void str2NumToReal(Args _arg)
{
    real r;
    str s;
    r = str2Num("3.15");
    s = strFmt("r = %1", r);
    info(s);
}
/*** Infolog output.
Message_@SYS14327 (02:36:12 pm)
r = 3.15
***/

static void str2NumExponentialSyntax(Args _args)
{
    Qty qty1, qty2, qty3;
    qty1 = str2num('1e-3'); // Bad syntax by the user.
    qty2 = str2num('1.e-3');
    qty3 = str2num('1.0e-3');
    info(strfmt('Result: %1; Expected: %2', num2str(qty1, 0,3,2,0), '0.001'));
    info(strfmt('Result: %1; Expected: %2', num2str(qty2, 0,3,2,0), '0.001'));
    info(strfmt('Result: %1; Expected: %2', num2str(qty3, 0,3,2,0), '0.001'));
}
/*** Infolog output. The first result differs from expectations.
Message_@SYS14327 (02:20:55 pm)
Result: 1,000; Expected: 0.001
Result: 0,001; Expected: 0.001
Result: 0,001; Expected: 0.001
***/

str2Time

Convertit une chaîne en valeur timeOfDay .

int str2Time(str _text)

Paramètres

Paramètre	Description
_SMS	Temps à utiliser pour calculer le nombre de secondes depuis minuit.

Valeur de retour

Le nombre de secondes entre minuit et le paramètre _text ; sinon, -1.

Remarques

str2Time("05:01:37") //Returns the value 18097.
str2Time("7 o'clock") //Returns the value -1.

Exemple

static void str2TimeExample(Args _arg)
{
    int i;
    i = str2Time("11:30");
    print i;
}

time2Str

Convertit une valeur timeOfDay en une chaîne qui inclut les heures, les minutes et les secondes.

str time2Str(int _time, int _separator, int _timeFormat)

Paramètres

Paramètre	Description
_Heure	Valeur timeOfDay .
_séparateur	Valeur d’énumération TimeSeparator qui indique les caractères compris entre les heures, les minutes et les secondes dans la chaîne de sortie.
_timeFormat	Valeur d’énumération TimeFormat qui indique si une horloge de 12 heures ou une horloge de 24 heures est utilisée.

Valeur de retour

Chaîne qui représente l’heure spécifiée.

Remarques

La valeur du paramètre _time est le nombre de secondes depuis minuit.

Exemple

static void TimeJob4(Args _args)
{
    timeOfDay theTime = timeNow();
    info( time2Str(theTime, TimeSeparator::Colon, TimeFormat::AMPM) );
}
/**
Message (04:33:56 pm)
04:33:56 pm
**/

uint2Str

Convertit un entier en chaîne. Cette fonction suppose que l’entier est sans signe.

str uint2Str(int integer)

Paramètres

Paramètre	Description
entier	Entier à convertir.

Valeur de retour

L’équivalent de chaîne de l’entier non signé spécifié.

Remarques

Utilisez cette fonction à la place de la fonction int2str pour les entiers très volumineux, tels que les ID d’enregistrement.

info(int2str(3123456789)); //returns -1171510507 as a string.
info(uint2str(3123456789)); //returns 3123456789 as a string.