Formateurs

21.09.2021

Les formateurs contrôlent l'affichage de nombres, d'angles, de chaînes de caractères, de valeurs calendaires et de périodes. Ils commencent toujours par un caractère "%", suivi d'un code, tel que %5.3g.

Formateurs standard

Les formateurs standard % ? et %& ? produisent tous les types de données dans un format standard. Les valeurs à virgule flottante sont produites en utilisant un nombre de places valides qui peut être défini dans l'onglet Général de la boîte de dialogue Propriétés de la base de données projet FlexPro. Si vous utilisez une variante avec le caractère &, les données comportant une unité sont éditées avec l'unité en annexe.

Valeur numérique

Ce formateur contrôle la façon dont les données numériques sont affichées. Vous pouvez choisir parmi une variété d'options de formatage. Vous pouvez aligner les chiffres d'un champ, indiquer si un exposant doit être affiché et, le cas échéant, dans quel format et sur quelle base, spécifier le nombre de positions après la virgule, et bien plus encore.

Syntaxe

%[Attribute][Field size][.Places]Formatter

La syntaxe du formateur de valeurs numériques se compose des éléments suivants :

Élément

Description

Attribut

Un ou plusieurs des caractères d'attribut suivants :

0

Remplit la taille du champ avec des zéros de tête.

&

Produit des quantités avec une unité ajoutée.

#

Émet le séparateur décimal même si aucun chiffre fractionnaire n'est émis.

+ ou espace

Le + émet également le signe de polarité positive. Un espace produit un espace à la place de +.

-

Place le nombre formaté aligné à gauche et remplit la largeur restante du champ avec des espaces.

'

Émet et regroupe la partie intégrale du nombre en utilisant le séparateur 1000ème pour une meilleure lisibilité.

[Invalid]

Remplace le point d'interrogation habituellement affiché pour les valeurs invalides par le texte spécifié entre crochets.

Taille du champ

Spécifie la taille (largeur) du champ dans lequel le nombre formaté doit être placé, aligné à gauche ou à droite. Si nécessaire, il est rempli d'espaces. Le nombre entier est toujours édité, même si la taille du champ n'a pas été spécifiée ou si une taille inférieure a été spécifiée. Le cas échéant, l'unité ajoutée est ignorée pour l'alignement et est placée à la place après la valeur numérique alignée.

Places

En fonction du formateur choisi, cela permet de sélectionner le nombre de places ou de chiffres fractionnaires valides. Si vous omettez cet élément, la valeur prédéfinie dans l'onglet Général de la boîte de dialogue Propriétés de la base de données projet est utilisée.

Formateur

f

N'inclut jamais l'exposant.

E, e *

Inclut toujours la mantisse et l'exposant.

G, g *

Un exposant n'est utilisé que s'il offre une présentation plus compacte.

N, n *

Un exposant en base exponentielle est toujours affiché.

B, b *

Un exposant en base 2 est toujours émis.

M, m *

Si la mantisse est égale à 1, alors seul l'exposant est affiché, sans la mantisse. Sinon, seule la mantisse est affichée sans l'exposant. Cet affichage est adapté pour la mise à l'échelle des axes logarithmiques, par exemple.

F

Au lieu d'un exposant, un préfixe SI est ajouté, par exemple 1,234 k au lieu de 1,234 E+003.

x, X

Affichage sous forme de nombre entier dans le système hexadécimal avec des lettres minuscules (x) ou majuscules (X).

d

Résultat en tant qu'entier dans le système dual.

i

Résultat sous forme de nombre entier dans le système décimal. Utilisez ce formateur au lieu de %f pour sortir de grandes valeurs entières de 64 bits en pleine résolution.

* Utilisez des lettres minuscules pour afficher l'exposant en exposant. Exemple : 10³ or 2³. Sinon, E+003 ou B+003 seront émis, par exemple.

Texte indexé

Ce formateur vous offre la possibilité d'affecter des textes à des valeurs numériques commençant par 0, qui sont ensuite affichés à la place des chiffres. Vous pouvez ainsi étiqueter les colonnes d'un graphique en colonnes, par exemple, avec un texte individuel. Ne confondez pas ce formateur avec le formateur de chaînes de caractères, qui ne peut afficher aucune donnée numérique.

Syntaxe

%("Text0"[, "Text1"[, ..., "Textn"]])

La syntaxe du formateur de texte indexé se compose des éléments suivants :

Élément

Description

Texte0... Texten

Le texte à éditer à la place des valeurs 0 à n.

Calendar Time

FlexPro enregistre les heures du calendrier (date et heure) sous forme de valeurs numériques contenant le nombre de secondes depuis le 1er janvier 1970 en "temps universel coordonné" (UTC). En utilisant un formateur d'heure de calendrier, vous pouvez afficher ces valeurs numériques sous forme d'heure de calendrier. FlexPro convertit automatiquement les valeurs UTC en fonction du fuseau horaire défini dans les Options régionales et linguistiques de Windows. Vous pouvez toutefois spécifier une option qui doit donner lieu à un résultat en temps universel coordonné. Le formateur spécifie les éléments de la valeur temporelle qui doivent être affichés. Il existe un élément de formatage correspondant pour chacun des éléments énumérés ci-dessous. Cet élément de mise en forme commence par un caractère %. Vous pouvez écrire n'importe quel texte entre les éléments de formatage individuels, où le signe de pourcentage doit être saisi comme %%.

Syntaxe

%[.Fractional digits]([UTC] Date)

La syntaxe de l'heure du calendrier formateur se compose des éléments suivants :

Élément

Description

Chiffres fractionnaires

Sélectionne le nombre maximum de chiffres fractionnaires pour les secondes. Si vous omettez cet élément, la valeur par défaut utilisée est 6, ce qui équivaut à une résolution de 1µs.

UTC

Produit la date en temps universel coordonné (UTC).

Date

Tout texte dans lequel les formateurs d'éléments suivants peuvent être incorporés :

Nom du jour de la semaine, en abrégé

%a

Nom du jour de la semaine

%A

Nom du mois, en abrégé

%b

Nom du mois

%B

Date et heure, en fonction des paramètres de la région et des options linguistiques de Windows

%c

Jour du mois au format décimal (00 - 31)

%d

Heure au format 24 heures (00 - 23)

%H

Heure au format 12 heures (01 - 12)

%I

Jour de l'année sous forme de nombre décimal (001 - 366)

%j

Mois sous forme de nombre décimal (01 - 12)

%m

Minute sous forme de nombre décimal (00 - 59)

%M

Indicateur A.M./P.M., basé sur les paramètres de la région et des options linguistiques de Windows

%p

Indicateur A.M./P.M

%P

Seconde sous forme de nombre décimal (00 - 59)

%S

Semaine du calendrier, commençant par le dimanche, sous forme de nombre décimal
(00 - 53)

%U

Semaine du calendrier, commençant par le lundi, sous forme de nombre décimal
(00 - 53)

%W

Jour de la semaine sous la forme d'un nombre décimal (0 - 6 ; dimanche est 0)

%w

Date, basée sur les paramètres de la région et des options linguistiques de Windows

%x

Heure, en fonction des paramètres de la région et des options linguistiques de Windows

%X

Année, à deux chiffres, sous forme de nombre décimal (00 - 99)

%y

Année, quatre chiffres, sous forme de nombre décimal (00 - 99)

%Y

Nom du fuseau horaire, en abrégé

%z

Nom du fuseau horaire

%Z

Signe en pourcentage

%%

Exemples

%(%A, the %th of %B %Y %H:%M)

Un exemple de ce résultat serait : "Tuesday, the 16th of February 2010 17:15".

%(UTC%A, the %th of %B %Y %H:%M UTC)

Un exemple de ce résultat serait : "Tuesday, the 16th of February 2010 04:15:00 PM"

%.0(%H:%M:%S) or %.0(%X)

N'émet que l'heure, les secondes sont donc émises sans chiffres fractionnaires.

Période

Les intervalles de temps peuvent être formatés en H:M:S ou D:H:M:S. Le nombre de chiffres fractionnaires ainsi que le nombre de positions pour l'heure ou le jour peuvent être ajustés.

Syntaxe

%[Places][.Fractional digits]Formatter

La syntaxe du formateur depériodes se compose des éléments suivants :

Élément

Description

Places

Spécifie le nombre de chiffres pour le jour ou les heures. Si nécessaire, il est rempli de zéros de tête.

Chiffres fractionnaires

Sélectionne le nombre maximum de chiffres fractionnaires pour les secondes. Si vous omettez cet élément, la valeur par défaut utilisée est 6, ce qui équivaut à une résolution de 1µs.

Formateur

t

Affichage en H:M:S.

T

Affichage en J:H:M:S.

Exemples

%3.2t

Formate l'intervalle de temps en HHH:MM:SS.ss.

%.0T

Formate l'intervalle de temps en J:HH:MM:SS. Les secondes sont émises sans chiffres fractionnaires.

Angle

Les angles peuvent être affichés en degrés, minutes, secondes (° ' '') ou comme une fraction de π. Les données d'angle existantes peuvent être formatées en degrés ou en radians.

Syntaxe

%[.Places]Formatter

ou

%[.Denominator]Formatter

La syntaxe de l'angle formateur se compose des éléments suivants :

Élément

Description

Places

Lors du renvoi en degrés, minutes, secondes, le nombre maximum de chiffres est spécifié pour les secondes. Si vous omettez l'élément, la valeur par défaut 6 est utilisée.

Dénominateur

Le renvoi sous forme de fraction de π spécifie le dénominateur de la fraction. Si vous omettez l'élément, au lieu d'éditer une fraction, un nombre décimal avec le nombre maximum de chiffres fractionnaires prédéfini dans l'onglet Général des propriétés de la base de données projet est édité.

Formateur

r, R

Produit des degrés, des minutes et des secondes.

p, P

Produit une fraction de π.

Utilisez des lettres majuscules si les données à formater sont en radians (0 à 2 π) et des lettres minuscules si les données sont en degrés (0 à 360).

Exemples

%.2r

Un exemple de ce résultat serait : "15° 12´ 24,34´´".

%.4P

Un exemple de ce résultat serait : "3/4 π".

%P

Un exemple de ce résultat serait : "0.75 π".

Chaîne de caractères

Vous pouvez limiter les chaînes de caractères à une longueur maximale ou les remplir jusqu'à une longueur minimale. Le texte peut être affiché comme étant justifié à gauche ou à droite.

Syntaxe

%[-][MinFieldSize][.MaxFieldSize]s

ou

%[-][MinFieldSize][.MaxFieldSize]S

La syntaxe du formateur dechaînes de caractères se compose des éléments suivants :

Élément

Description

-

S'il est spécifié, l'alignement du champ est justifié à gauche ; sinon, il est justifié à droite.

MinFieldSize

Spécifie la taille minimale du champ en caractères. La valeur n'est pertinente que si la chaîne est plus courte que la valeur spécifiée. Il est ensuite rempli d'espaces.

MaxFieldSize

Spécifie la taille minimale du champ en caractères. La valeur n'est pertinente que si la chaîne est plus longue que la valeur spécifiée. Les caractères excédentaires sont alors coupés.

Formateur

S

Renvoi avec un double caractère '\'. Cela permet d'éviter que le caractère "\" du texte soit interprété comme le symbole de début dans les séquences de contrôle, comme "\B" pour le gras.

s

Résultat inchangé. Les séquences de contrôle sont interprétées et prises en compte dans la mise en forme du texte.

Exemples

%s

Un exemple de ce résultat serait : "Test".

%.3s

Un exemple de ce résultat serait : "Tes".

%6s

Un exemple de ce résultat serait : " Test".

Format spécial

Les formats spéciaux suivants conviennent notamment pour la numérotation dans les tableaux et pour les titres de chapitre dans les documents.

Syntaxe

Formateurs%

La syntaxe du format spécial formateur se compose des éléments suivants :

Élément

Description

Formateurs

a, A

Numérotation alphabétique avec des lettres majuscules ou minuscules.

o, O

Chiffre romain avec des lettres majuscules ou minuscules.

c, C

Numéro chinois, normal ou comptable.

j

Numéro japonais.

Exemples

%a

1, 2, 3, 4 est formaté comme a, b, c, d.

%A

1, 2, 3, 4 est formaté comme A, B, C, D.

%o

1, 2, 3, 4 est formaté comme i, ii, iii, iv.

%O

1, 2, 3, 4 est formaté comme I, II, III, IV.

%c

1, 2, 3, 4 est formaté comme 一, 二, 三, 四.

%C

1, 2, 3, 4 est formaté comme 壹, 贰, 叁, 肆.

%j

1, 2, 3, 4 est formaté comme 一, 二, 三, 四.

 

Vous serez probablement intéressé par les articles suivants :