ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Standard functions / String functions
  • Format détaillé de la chaîne de caractères à obtenir
  • Limites
  • Conversion d'une taille exprimée en octets
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Transforme un numérique (entier, réel ou monétaire) en une chaîne de caractères selon le format spécifié.
Example
NumToString(123) // Renvoie "123"
NumToString(1.23) // Renvoie "1.23"
NumToString(12345.5, "+10.2f") // Renvoie " +12345.50"
NumToString(12345.5, "-+10.2f") // Renvoie "+12345.50 "
NumToString(12345.5, "+010.2f") // Renvoie "+012345.50"
NumToString(12345.5, "010.2f") // Renvoie "0012345.50"

NumToString(12345.5, "10.2fS")
// Renvoie " 12 345.50" (le séparateur des milliers est un " ")

NumToString(12345.5, "10,2fS")
// Renvoie " 12 345,50" (le séparateur décimal est une ",")
Syntax
<Résultat> = NumériqueVersChaîne(<Nombre> [, <Format>])
<Résultat>: Chaîne de caractères
Nombre exprimé sous forme de chaîne de caractères en fonction du format choisi.
Si le paramètre <Nombre> est une chaîne, cette chaîne est restituée telle quelle. Le format est ignoré.
<Nombre>: Entier ou réel
Numérique à convertir sous forme de chaîne de caractères (selon le format spécifié).
<Format>: Chaîne de caractères optionnelle, constante ou variable de type FormatNumérique
  • Format de la chaîne de caractères défini avec une variable de type FormatNumérique.
  • Format de la chaîne de caractères, exprimé sous la forme :
    "[<Cadrage>][<Signe>][<Zéro>][<Taille>][<.Précision>]<Type>[<Millier>]"


    Pour plus de détails, consultez les remarques.
Remarks

Format détaillé de la chaîne de caractères à obtenir

Pour convertir un numérique en une chaîne, il est nécessaire de spécifier le format de la chaîne de caractères à obtenir. Ce format est exprimé sous la forme :
"[<Cadrage>][<Signe>][<Zéro>][<Taille>][<.Précision>]<Type>[<Millier>]"
Les différentes valeurs possibles sont les suivantes :
<Cadrage>Si ce paramètre est spécifié, justifie le nombre à gauche (<Cadrage> = "-").
Par défaut, le nombre est justifié à droite.
<Signe>Si ce paramètre est spécifié, force le signe pour les chiffres positifs (<Signe> = "+"). Ce signe apparaîtra à gauche du premier chiffre significatif.
Par défaut, seuls les chiffres négatifs ont un signe "-" à gauche du premier chiffre significatif.
Cas particulier : si ce paramètre est spécifié et si le nombre vaut 0, le signe "+" sera affiché. De même si un nombre négatif devient égal à 0.
<Zéro>Si ce paramètre est spécifié (<Zéro> ="0"), le nombre sera complété par des zéro à gauche du premier chiffre significatif si la partie significative du nombre est plus petite que la taille demandée et si le nombre est justifié à droite.
Par défaut, le nombre n'est pas complété à gauche par des "0".
Par exemple : NumériqueVersChaîne(123,"05d") donnera "00123".
<Taille>Fixe la largeur totale de la chaîne résultat. La largeur totale correspond aux éléments suivants : signe, séparateur de milliers, point décimal, exposant, parties entières et décimales du nombre. Cette taille doit être inférieure à 100.
Si la taille indiquée est trop petite pour contenir la partie significative du nombre, cette taille sera ignorée.
Par défaut, le nombre aura la taille de sa partie significative (il ne pourra pas être complété par des zéro). Idem si <Taille> = 0.
Si la taille indiquée est plus grande que la partie significative du nombre :
  • la chaîne résultat sera complétée par des espaces à droite si le nombre est justifié à gauche,
  • la chaîne résultat sera complétée par des espaces ou zéros à gauche si le nombre est justifié à droite.
<.Précision>Fixe le séparateur décimal (caractères "." ou ",") et le nombre de décimales (uniquement pour les <Types> flottant ("f") et exposant ("e")).
Le séparateur décimal :
  • Si le séparateur des décimales est une virgule, le séparateur des décimales sera celui défini :
    • dans les paramètres linguistiques de Windows.
  • Si le séparateur des décimales indiqué est un point, le séparateur décimal utilisé sera un point.
Remarques :
  • La fonction ChangeSéparateur n'a pas d'effet sur ce séparateur. En effet, cette fonction agit uniquement sur le masque d'affichage des numériques dans les champs.
Nombre de décimales :
  • Le nombre de décimal doit être inférieur à 100.
  • Si le nombre de décimales du nombre est plus grand que <Précision>, la partie décimale sera arrondie au nombre de décimales demandées.
  • Si le nombre de décimales du nombre est plus petit que <Précision>, la partie décimale sera complétée par des "0" à droite.
  • La valeur de <Précision> peut être plus grande que <Taille>. Dans ce cas <Taille> est ignoré.
<Type>Type du résultat, paramètre obligatoire :
  • d : Entier :
    Un nombre réel sera arrondi à l'entier le plus proche.
  • e : Notation exponentielle :
    Si <Précision> n'est pas indiqué, 6 chiffres par défaut.
  • f : Notation décimale :
    Si <Précision> n'est pas indiqué, 6 chiffres par défaut.
  • x et X : Notation hexadécimale (X pour des lettres majuscules) :
    Seule la partie entière du nombre est prise en compte (pas d'arrondi).
    Cas particulier :
    1. Taille non précisée et nombre négatif : 20 caractères hexadécimaux pour un monétaire, 8 caractères pour tous les autres numériques.
    2. Nombre négatif : la taille de la chaîne résultat sera au minimum la taille permettant d'indiquer le bit de signe.
    Par exemple : -32767 dans le format "3X" donnera "8001"
  • o : Notation octale :
    Seule la partie entière du nombre est prise en compte (pas d'arrondi).
    Cas particulier :
    1. Taille non précisée et nombre négatif : 27 caractères pour un monétaire, 11 caractères pour tous les autres numériques.
    2. Nombre négatif : la taille de la chaîne résultat sera au minimum la taille permettant d'indiquer le bit de signe.
    Par exemple : -32767 dans le format "3o" donnera "700001"
<Millier>Séparateur de milliers (<Millier> = "S" ou "s"). Les chiffres de la partie entière du nombre seront regroupés par 3 et séparés par le caractère séparateur de milliers défini dans Windows. Si le signe est présent, il sera toujours immédiatement à gauche du premier chiffre significatif. Il ne peut pas y avoir de séparateur des milliers entre le signe et le premier chiffre.
Reports and Queries

Limites

  • Format "f" donne un résultat correct pour les nombres allant de -1e+17 à 1e+17.
  • Formats "x", "d" ou "o" : la partie entière ne doit pas dépasser 99 999 999 999 999 999.

Conversion d'une taille exprimée en octets

Pour convertir une taille exprimée en octets, utilisez la fonction TailleVersChaîne.
Business / UI classification: Neutral code
Component: wd300std.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Como mostrar pontos e virgula
cyTotal_aberto is currency=10600385.15
STC_TOTAL+=" Aberto:"+NumToString(cyTotal_aberto,"10,2fS") // "10,2f"
//RESULTADO SERA: 10.600.385,15
amarildo
16 Mar. 2020

Last update: 09/18/2024

Send a report | Local help