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

Nombre de caractères dans la chaîne de sortie.

format

optionnel

caractère Format à appliquer à la chaîne de sortie. Par exemple, "(9999,99)"

Sortie

Caractère.

Exemples

Exemples basiques

Chaînes sans mise en forme

Renvoie " 125,2" :

STRING(125,2; 6)

Renvoie "25,2" (-1 est tronqué car le paramètre longueur est inférieur au nombre de chiffres et de caractères de formatage dans le paramètre numéro) :

STRING(-125,2; 4)

Renvoie " 125,2" :

STRING(-125,2; 7)

Chaînes mises en forme

Renvoie "  (125,20)" :

STRING(-125,2; 10;  "(9999,99)")

Renvoie "25,20" (1 est tronqué car le paramètre longueur est inférieur au nombre de chiffres et de caractères de formatage dans le paramètre numéro) :

STRING(125,2; 6;  "(9999,99)")

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 besoin, la valeur renvoyée est complétée ou tronquée :

STRING(Numéro_employé; 10)

Remarques

Valeurs renvoyées remplacées et tronquées

La fonction STRING( ) convertit numéro en chaîne de caractères en adoptant la longueur indiquée dans longueur :

  • Si numéro est inférieur à longueur, des espaces de début sont ajoutés à la valeur renvoyée
  • Si numéro est supérieur à longueur, la valeur renvoyée est tronquée à partir de la gauche

Mise en forme de la valeur renvoyée

Le paramètre format facultatif formate la valeur renvoyée en ajoutant le symbole du dollar, le symbole de pourcentage, des décimales, des virgules, des indicateurs négatifs ou des parenthèses. Le format doit être placé entre guillemets doubles.

Le chiffre 9 joue le rôle de paramètre fictif pour les chiffres à formater. Assurez-vous que le nombre correct de 9 s'affiche. Vous devez également prendre en compte les décimales et les caractères de formatage (par exemple, le signe du dollar et les parenthèses pour les nombres négatifs) lorsque vous indiquez la valeur de la longueur.

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.

Guide de création de scripts ACL 14.1