Les fonctions ToText et
CStr sont équivalentes.
Description
La fonction ToText convertit des valeurs booléennes, numériques, monétaires, de date, d'heure et de type date/heure en chaînes de texte.
Arguments
| |
|---|
| "x" est une valeur booléenne convertie en chaîne de type True (vrai) ou False (faux).
|
Valeurs numériques et monétaires | "x" est une valeur numérique ou monétaire à convertir en chaîne de texte ; il peut s'agir d'un nombre entier ou fractionnaire. "y" est un nombre entier indiquant le nombre de décimales auxquelles ramener la valeur de "x". (Cet argument est facultatif.). "z" est une chaîne de caractère unique indiquant le caractère à utiliser pour séparer les milliers dans "x". C'est par défaut le caractère défini dans l'option Paramètres régionaux ou internationaux du Panneau de configuration Windows. (Cet argument est facultatif.) "w" est une chaîne de caractère unique indiquant le caractère à utiliser comme séparateur décimal dans "x". C'est par défaut le caractère défini dans l'option Paramètres régionaux ou internationaux du Panneau de configuration Windows. (Cet argument est facultatif.)
|
Valeurs numériques et monétaires (application d'un format) | "x" est une valeur numérique ou monétaire à convertir en chaîne de texte ; il peut s'agir d'un nombre entier ou fractionnaire. "y" est une chaîne de texte utilisée pour indiquer le format d'affichage de la valeur de "x". Pour en savoir plus sur la création d'une chaîne de format, voir Chaînes de format. "z" est un nombre entier indiquant le nombre de décimales auxquelles ramener la valeur de "x". (Cet argument est facultatif.) "w" est une chaîne de texte unique indiquant le caractère à utiliser pour séparer les milliers dans "x". C'est par défaut le caractère défini dans l'option Paramètres régionaux ou internationaux du Panneau de configuration Windows. (Cet argument est facultatif.) "q" est une chaîne de texte unique indiquant le caractère à utiliser dans "x" comme séparateur décimal. C'est par défaut le caractère défini dans l'option Paramètres régionaux ou internationaux du Panneau de configuration Windows. (Cet argument est facultatif.)
|
| "x" est une valeur de date à convertir en chaîne de texte.
|
| "x" est une valeur d'heure à convertir en chaîne de texte. "z" est une chaîne de texte à utiliser comme étiquette (am) avant 12 heures (pour l'affichage des heures en format anglo-saxon). (Cet argument est facultatif.) "w" est une chaîne de texte à utiliser comme étiquette (pm) après 12 heures (pour l'affichage des heures en format anglo-saxon). (Cet argument est facultatif.)
|
valeurs de type date/heure | "x" est une valeur de type date/heure à convertir en chaîne de texte. "z" est une chaîne de texte à utiliser comme étiquette (am) avant 12 heures (pour l'affichage des heures en format anglo-saxon). (Cet argument est facultatif.) "w" est une chaîne de texte à utiliser comme étiquette (pm) après 12 heures (pour l'affichage des heures en format anglo-saxon). (Cet argument est facultatif.)
|
Action
La fonction ToText convertit des valeurs booléennes, numériques, monétaires, de date, d'heure et de type date/heure en chaînes de texte.
Exemple d'utilisation
Cette fonction permet de convertir une valeur booléenne, numérique, monétaire, de date, d'heure ou de type date/heure en chaîne de texte apparaissant sous forme de texte dans un rapport (lettres types, commentaires, etc.).
Exemples
ToText({orders.SHIPPED})Renvoie la valeur True (vrai) lorsque la valeur de ({commandes.Commande expédiée}) est True (vrai).
ToText(123.45)
Renvoie "123,45".
ToText(12345.6749,2)
Renvoie "12345,67".
ToText(12345.6750,2)
Renvoie "12345,68".
ToText(12345.4999,0)
Renvoie "12345".
ToText(12345.5000,0)
Renvoie "12346".
ToText({file.AMT} * {file.QUANTITY})Renvoie 44,890.20 lorsque MONTANT = 24.45 et Quantité = 1836.
ToText permet de créer une phrase par la combinaison (enchaînement) d'un nombre converti ou de toute autre valeur avec d'autres chaînes de texte :
"The base price of item # " + {file.ITEM NUMBER} + " is $" + ToText({file.BASE PRICE}) + "."Imprime la phrase "Le prix de base de l'article A1/4520/B12 est 250,00 €." lorsque la référence de l'article est A1/4520/B12 et le prix de base est de 250 €, converti en texte et formaté avec deux décimales.
ToText(CDate(1996, 11, 1), "yy MMM dd, dddd")
Renvoie vendredi 1 novembre 1996.
ToText(DateTime(1995,10,12,3,30,11),"HH:mm, yy MMMM ddd")
Renvoie jeudi 12 octobre 1995 03:30:11.
ToText(Time(12, 10, 10), "HH*mm*ss tt", "amStr", "pmStr")
Renvoie 12*10*10.
Commentaires
Conversion de valeurs booléennes :
La fonction ToText, utilisée avec des valeurs booléennes, est particulièrement utile pour la combinaison (enchaînement) d'une valeur booléenne avec un autre texte. Sinon, vous pouvez mettre en forme un champ booléen de façon qu'il apparaisse comme True (vrai) ou False (faux) dans votre rapport simplement en modifiant le format à partir de l'onglet Booléen de l'Editeur de mise en forme.
Conversion de valeurs numériques et monétaires :
Si le nombre de décimales est spécifié, cette fonction ne tronque pas le nombre lors de sa conversion en texte, mais l'arrondit au nombre de décimales indiqué. Pour en savoir plus sur la procédure d'arrondi, voir
Arrondi.
Conversion de valeurs de date, d'heure et de type date/heure :
Tout caractère, à l'exception des caractères de format de type date ou heure, peut être utilisé dans la chaîne de format. Par exemple, vous pouvez choisir d'utiliser une barre oblique pour séparer les différents éléments d'une date (jour, mois, année), comme "12/30/95", ou utiliser les deux points pour séparer les éléments de l'heure (heure, minutes, secondes), comme "12:30:10".
Si vous souhaitez utiliser l'un des caractères ci-dessus dans la chaîne de format, il doit apparaître entre guillemets. Par exemple : ToText(CDateTime(1995,10,12,13,20,22), "MM/jj/aa hh 'h' mm 'min' ss 'sec' tt", 'am', 'pm') = "10/12/95 01 h 20 min 22 sec pm"
Définition d'arguments facultatifs
Plusieurs arguments de la fonction ToText sont indiqués comme facultatifs. Toutefois, vous ne pouvez laisser un argument vide que si tous les arguments qui le suivent sont également laissés vides. En d'autres termes, vous ne pouvez omettre de renseigner les arguments y et z si vous renseignez l'argument w. Il est cependant possible de laisser un, deux ou tous les arguments facultatifs en blanc, tant qu'aucun argument n'est renseigné à la suite. Les combinaisons suivantes sont possibles lorsque vous spécifiez des arguments pour la fonction ToText :
Les caractères de format "t" ou "tt" dans une chaîne de format de type heure fournissent des chaînes par défaut permettant d'indiquer les heures situées avant 12 heures ou après 12 heures. "t" produit un caractère unique, "a" ou "p", alors que "tt" produit la chaîne complète, soit "am" ou "pm". Vous pouvez spécifier vos propres chaînes personnalisées pour définir les chaînes am/pm. Consultez les arguments pour convertir les valeurs d'heure et de type date/heure avec ToText dans la section "Arguments" ci-dessus. Lorsque vous spécifiez vos propres chaînes am/pm, les caractères de format "t" et "tt" ont les mêmes effets (création de chaînes à un caractère ou plusieurs caractères).