FORMAT

Syntaxe

Format possède deux formes ; l'une pour les données de type numérique et l'autre pour celles de type texte/caractère.

Pour les données de type numérique :

FORMAT(colName, width [, precision [, format_type [, alignment [, padding]]]])

Pour les données de type texte/caractère :

FORMAT(colName, width [, alignment])

Paramètres

colName

La macro examine colName, détermine son type de données, puis impose les règles appropriées pour les paramètres suivants en conséquence.

width

La largeur doit être assez importante pour contenir le résultat complet ; sinon le résultat est tronqué. Les valeurs admises sont comprises entre 1 et 29 si colName est numérique et entre 1 et 255 dans le cas contraire.

precision

La précision est le nombre de chiffres après le séparateur décimal. Les valeurs admises sont comprises entre 0 et 15. Si la valeur est égale à zéro, le résultat est un entier. La précision par défaut est de 2.

format_type

Les mots clés valides de format_type sont les suivants :

PERIOD	Le point (.) est utilisé comme symbole décimal. Aucun symbole de groupement des chiffres n'est utilisé. Il s'agit de la valeur par défaut.
COMMA	La virgule (,) est utilisée comme symbole décimal. Aucun symbole de groupement des chiffres n'est utilisé.
PERIOD_COMMA	Le point est utilisé comme symbole décimal et la virgule comme symbole de groupement des chiffres.
COMMA_PERIOD	Virgule comme symbole décimal et point comme symbole de groupement des chiffres.

alignment

Les mots clés valides pour l'alignement sont LEFT et RIGHT. La valeur par défaut est RIGHT pour les données de type numérique et LEFT pour les données de type texte/caractère.

padding

Les mots clés valides pour le remplissage sont SPACE et ZERO. La valeur par défaut est SPACE. ZERO est ignoré (SPACE est utilisé à la place) si l'alignement est LEFT.

Notez que les chaînes numériques contenues dans des données de type texte/caractère sont traitées comme texte/caractère. Notez également que la forme numérique accepte plusieurs mots clés facultatifs possédant chacun une valeur par défaut. Toutefois, pour remplacer la valeur par défaut du deuxième mot clé facultatif ou des suivants, vous DEVEZ coder les valeurs par défaut des mots clés facultatifs précédents (dans les faits, ils deviennent obligatoires). Par exemple : pour remplacer l'alignement par un alignement à gauche (LEFT), vous devez coder : FORMAT(myNumCol, 10, 2, PERIOD, LEFT).

Description

FORMAT convertit des données numériques en chaîne avec diverses options de formatage pour contrôler et définir la chaîne en sortie. Cela est particulièrement utile pour créer des fichiers d'instantané avec des formats spécifiques à des fins de publipostage.

Exemples

L'exemple ci-après définit une zone dérivée à l'aide de FORMAT.

Les exemples ci-après montrent la même zone, AvgMthPayment, dans trois formats.

Non formaté :

Formaté à l'aide de FORMAT(Behavior.AvgMthPayment,10,2,right,space) :

Formaté à l'aide de FORMAT(Behavior.AvgMthPayment,10,4) :