FORMAT

La fonction de script FORMAT vous permet de formater des nombres en ajoutant ou supprimant les zéros non significatifs. Vous pouvez spécifier le nombre de zéros non significatifs pour ajouter ou supprimer les décimales dans les nombres à virgule flottante.

Syntaxe

FORMAT (number [,format])

Paramètres

• FORMAT
  Formate des nombres
  
• number
  Nombre à formater
  Format : littéral de script ou variable de script
• format
  Zéros servant de caractères de remplacement pour le nombre de zéros non significatifs
  nombres à virgule flottante uniquement : spécifiez un point décimal comme séparateur et le nombre de chiffres après la virgule
  Format : littéral de script ou variable de script
  Défaut : 0

Code retour : Nombre avec ou sans zéros non significatifs, selon ce que vous spécifiez

Remarques :

• Le nombre de zéros saisi dans le paramètre Format sert de caractère de remplacement pour le nombre total de chiffres. Si le nombre a moins de chiffres, la valeur reste inchangée. Des zéros non significatifs sont supprimés si vous utilisez ce paramètre.
• Si vous incluez le signe plus (+) comme premier caractère dans Format, le signe plus s'affiche également dans les nombres positifs ("+1,00"). Dans ce cas, la variable cible à laquelle vous affectez le code retour de la fonction FORMAT doit être de type chaîne de caractères. Si le résultat est nul après la suppression de toutes les décimales, le signe algébrique est alors supprimé. Pour plus d'informations, voir Types de données des variable de script.
• Vous pouvez spécifier le nombre de décimales dans les nombres à virgule flottante. Définissez un point décimal comme séparateur dans le paramètre Format. Saisissez autant de zéros après le séparateur que vous souhaitez de décimales dans votre nombre. Les nombres ayant plus de décimales sont tronqués sans être arrondis. Si vous ne spécifiez pas de point décimal, toutes les décimales sont supprimées. Si le nombre a moins de décimales que vous en avez spécifié dans le paramètre Format, les espaces restants sont remplis par des zéros de fin.

Exemples

L'exemple suivant illustre la suppression des zéros non significatifs du code retour à 16 chiffres de la fonction de script SYS_BUSY_60, et l'impression du résultat dans le rapport d'activation :

:SET &SRV#=SYS_BUSY_60()
:SET &RET#=FORMAT(&SRV#)
:PRINT &RET#

L'exemple suivant illustre l'ajout de zéros non significatifs pour obtenir la longueur spécifiée de 5 chiffres, et l'impression du résultat (00125) dans le rapport d'activation :

:SET &RET#=FORMAT("125","00000")
:PRINT &RET#

L'exemple suivant illustre la suppression des zéros non significatifs et l'impression du résultat (333) dans le rapport d'activation :

:SET &RET#=FORMAT("0000333","00")
:PRINT &RET#

Dans l'exemple suivant, le nombre ne change pas car il n'y a pas de zéros non significatifs et le nombre tel qu'il est correspond au format spécifié :

:SET &RET#=FORMAT("555","00")
:PRINT &RET#

L'exemple suivant illustre le formatage d'un nombre à virgule flottante de sorte à ce qu'il n'ait qu'une décimale et écrit le résultat (-0,7) dans le rapport d'activation : 

:DEFINE &NUM#,float
:DEFINE &RET#,string
:SET &NUM#=-0.75
:SET &RET#=FORMAT(&NUM#,"00.0")
:PRINT &RET#

L'exemple suivant illustre la suppression de toutes les décimales et l'impression du résultat (0000) dans le rapport d'activation :

:DEFINE &NUM#,float
:DEFINE &RET#,string
:SET &NUM#=0.65
:SET &RET#=FORMAT(&NUM#,"0000")
:PRINT &RET#

Voir aussi :