Fonction STRING( )
Convertit une valeur numérique en chaîne de caractères.
Syntaxe
STRING(numéro; longueur <;format>)
Paramètres
| Nom | Type | Description |
|---|---|---|
| nombre |
numérique |
Valeur numérique à convertir en chaîne. |
| longueur | numérique |
Longueur de la chaîne de sortie en caractères.
Assurez-vous que la longueur que vous spécifiez laisse suffisamment d'espace pour la longueur numérique la plus longue d'un champ, y compris pour les éventuels caractères de format non numérique si vous spécifiez le paramètre facultatif format. |
| format
optionnel |
caractère |
Le format à appliquer à la chaîne de sortie. Format doit être placé entre guillemets doubles. Par exemple, "(9999,99)" Utilisez le paramètre facultatif format pour ajouter la mise en forme à la chaîne de sortie qui n'est pas présente dans les données source. Vous pouvez ajouter un signe dollar, un signe pour cent, un ou plusieurs espaces réservés, un séparateur de milliers, des parenthèses, etc. Remarque Les caractères de format non numérique que vous spécifiez allongent numéro. |
Sortie
Caractère.
Exemples
Exemples simples, sortie sans mise en forme
Valeur numérique 125,2
Renvoie " 125,2" :
STRING(125,2; 6)
La chaîne de sortie est précédée d'un espace de début car la valeur longueur est de 6, soit un caractère de plus que le nombre de chiffres et de caractères de mise en forme de numéro.
Valeur numérique -125,2
Renvoie "25,2" :
STRING(-125,2; 4)
La chaîne de sortie est tronquée car la valeur longueur est 4, soit deux caractères de moins que le nombre de chiffres et de caractères de mise en forme de numéro.
Renvoie " 125,2" :
STRING(-125,2; 7)
La chaîne de sortie est précédée d'un espace de début car la valeur longueur est 7, soit un caractère de plus que le nombre de chiffres et de caractères de mise en forme de numéro.
Exemples simples, sortie mise en forme
Valeur numérique 125,2
Renvoie "25,20" :
STRING(125,2; 6; "(9.999,99)")
La chaîne de sortie est tronquée car la valeur longueur est 6, soit un caractère de moins que la valeur numéro après que le format spécifié a été appliqué.
Renvoie "125,20" :
STRING(125,2; 7; "(9.999,99)")
Remarque
En partant de la droite, les caractères que vous spécifiez pour format sont inclus dans le calcul de la longueur de numéro, même si un caractère de mise en forme n'est pas obligatoire pour une instance spécifique de numéro. Dans les exemples ci-dessus, la parenthèse de droite est comptée comme caractère, même si elle n'est pas obligatoire pour une valeur positive dans numéro.
Valeur numérique -125,2
Renvoie " (125,20)" :
STRING(-125,2; 10; "(9.999,99)")
La chaîne de sortie est précédée de deux espaces de début car la valeur longueur est 10, soit deux caractères de plus que la valeur numéro après que le format spécifié a été appliqué.
Exemple simple, entrée de champ
Renvoie des valeurs numériques dans le champ Numéro_employé sous forme de chaînes de caractères d'une longueur de 10 caractères. Si nécessaire, la chaîne de sortie est précédée d'un ou plusieurs espaces, ou tronquée :
STRING(Numéro_employé; 10)
Remarques
Mise en forme de la chaîne de sortie
Vous pouvez mettre la chaîne de sortie en forme pour afficher une mise en forme éventuellement absente des données source.
Chiffres d'espace réservé dans le format
Dans le format que vous spécifiez, le chiffre 9 sert d'emplacement réservé pour les chiffres. Assurez-vous de spécifier suffisamment de chiffres pour l'emplacement réservé afin de tenir compte de la valeur numérique la plus longue d'un champ. Par exemple, si un champ contient des montants allant jusqu'à 5 000 000 $ et deux décimales, vous devez spécifier neuf chiffres pour l'emplacement réservé : "9 999 999,99$".
Effet du format sur la longueur minimum requise pour la chaîne de sortie
La valeur que vous spécifiez pour longueur doit, au minimum, être suffisamment longue pour tous les chiffres de la valeur la plus longue d'un champ ainsi que pour tous les caractères de mise en forme que vous spécifiez.
Si vous souhaitez ajouter le signe dollar et des séparateurs de milliers aux valeurs du champ contenant des montants allant jusqu'à 5 000 000 $, vous devez spécifier au moins 13 pour longueur. 9 chiffres + 4 caractères de mise en forme non numériques.
Renvoie les valeurs numériques du champ Montant sous la forme de chaînes de caractères dans le format spécifié.
STRING(Montant; 13; "$9.999.999,99")
Renvoie 4 789 123,50$ comme chaîne de caractères :
STRING(4789123,50; 13; "$9.999.999,99")
Fonctions associées
La fonction STRING( ) est l'opposé de la fonction VALUE ( ), qui convertit des données caractère en données numériques.
