DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des chaînes
  • Propriétés spécifiques à la description des variables de type FormatNumérique
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
FormatNumérique (Type de variable)
En anglais : NumericFormat
Le type FormatNumérique permet de définir toutes les caractéristiques du format utilisable avec la fonction NumériqueVersChaîne. Les caractéristiques de ce format peuvent être définies et modifiées à l'aide de différentes propriétés WLangage.
Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
Exemple
f est un FormatNumérique
f.Notation = fnnDécimal
f.Signe = fnsToujours
f.ChiffresAprèsVirgule = 4
f.LongueurMinimale = 8
f.SéparateurMilliers = "'"
f.CaractèreRemplissage = " "
sRésultat est chaîne = NumériqueVersChaîne(1234.567, f)
Propriétés

Propriétés spécifiques à la description des variables de type FormatNumérique

Nom de la propriétéType manipuléEffet
AlignementConstante de type EntierCadrage du nombre. Cette propriété peut également être utilisée pour indiquer de quel côté les caractères de remplissage seront ajoutés si nécessaire :
  • fncDroite (Valeur par défaut) : Cadrage à droite, les caractères de remplissage seront ajoutés à gauche.
  • fncGauche : Cadrage à gauche, les caractères de remplissage seront ajoutés à droite.
CaractèreRemplissageCaractèreCaractères à utiliser si la chaîne de caractères est plus longue que la longueur du nombre à afficher.
Exemple : afficher '3.14' sur 6 caractères avec "x" comme caractère de remplissage donne pour résultat "3.14xx".
ChiffresAprèsVirguleEntierNombre de chiffres à mettre après la virgule lors d'une utilisation du format décimal. Par défaut, il y a 6 chiffres après la virgule.
Exemple : afficher '3.14' avec 4 chiffres après la virgule donne pour résultat '3.1400'.
Remarques :
  • Le nombre de décimal doit être inférieur à 100.
  • Si le nombre de décimales du nombre est plus grand que la propriété ChiffresAprèsVirgule, 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 la propriété ChiffresAprèsVirgule, la partie décimale sera complétée par des "0" à droite.
LongueurMinimaleEntierLongueur minimale de la chaîne de caractères. Cette propriété est liée à la propriété Alignement. En effet, le nombre de caractères de remplissage correspondra à la longueur totale minimale moins la longueur du nombre en lui-même. Si le nombre à afficher est plus grand que la longueur minimale, la propriété LongueurMinimale n'est pas prise en compte.
Remarque : La longueur 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.
MajusculesBooléen
  • Vrai pour utiliser des majuscules lors de l'affichage d'un nombre dans un format utilisant des lettres (par exemple : 0xAB24DA),
  • Faux pour utiliser des minuscules.
NotationConstante de type EntierType de notation à utiliser. Soit "normal" (décimal, c'est à dire `12.34`), soit d'autres types d'affichages (binaire, hexadécimal, octal, forme exponentielle).
  • fnnBinaire : Notation binaire.
  • fnnDécimal (Valeur par défaut) : Notation décimale.
  • fnnExponentiel : Notation exponentielle.
  • fnnHexadécimal : Notation hexadécimale.
  • fnnOctal : Notation octale.
PréfixeChaîne de caractèresTexte à mettre avant la valeur du nombre lors d'un affichage en mode chaîne de caractères. Cette propriété peut correspondre à :
  • une chaîne personnalisée.
    Exemple : l'affichage de '3.14' avec le préfixe 'abc' affiche 'abc3.14'.
  • la constante fnpAuto pour définir un préfixe automatique. Dans ce cas :
    • format décimal ou exponentiel : pas de préfixe.
    • format binaire : 0b
    • format hexadécimal : 0x
    • format octal : 0o
SéparateurDécimalChaîne de caractèresTexte à utiliser comme séparateur décimal. Par défaut, le séparateur décimal pris en compte correspond à celui défini pour la langue en cours (onglet "Langues" de la fenêtre de description du projet).
Exemple : l'affichage de '3.14' avec le séparateur décimale "virgule" donne '3virgule14'.
SéparateurMilliersCaractèreCaractère à utiliser pour séparer les paquets de 3 zéros. Par défaut, le séparateur de milliers n'est pas activé.
Exemple : l'affichage de 10000 avec le caractère 'Z' utilisé en tant que séparateur de milliers donne '10Z000'.
SigneConstante de type EntierAffichage du signe :
  • fnsMoinsSiNégatif (Valeur par défaut) : Le signe '-' est affiché uniquement si le nombre est négatif.
  • fnsParenthèsesSiNégatif : Si le nombre est négatif, il est entouré par des parenthèses.
  • fnsToujours : Le signe est toujours affiché,
SigneExponentielleConstante de type EntierAffichage du signe lors d'un affichage sous forme exponentielle :
  • fnsMoinsSiNégatif : Le signe est affiché uniquement si le nombre est négatif.
  • fnsToujours : Le signe est toujours affiché.
Version minimum requise
  • Version 2024
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 30/05/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale