Data.DB.TAggregateField.DisplayFormat

Aller au parent : TAggregateField

Delphi

property DisplayFormat: string read FDisplayFormat write SetDisplayFormat;

C++

__property System::UnicodeString DisplayFormat = {read=FDisplayFormat, write=SetDisplayFormat};

Propriétés

Type	Visibilité	Source	Unité	Parent
property	published	Data.DB.pas Data.DB.hpp	Data.DB	TAggregateField

Description

Détermine comment les valeurs numériques et horaires sont formatées pour leur affichage dans un contrôle orienté données.

Utilisez la propriété DisplayFormat afin de redéfinir le formatage automatique d'un champ pour l'affichage lorsque ResultType a la valeur ftFloat, ftCurrency, ftDate, ftTime ou ftDateTime.

Quand ResultType a la valeur ftFloat ou ftCurrency, la valeur de DisplayFormat est une chaîne qui code le formatage des données en utilisant les spécificateurs du tableau suivant :

Spécificateur	Signification
0	Emplacement d'un chiffre. Si la valeur en cours de formatage a un chiffre à la position où le "0" apparaît dans la chaîne de formatage, alors ce chiffre est copié dans la chaîne de sortie. Sinon, un "0" est stocké à cette position dans la chaîne de sortie.
#	Emplacement d'un chiffre. Si la valeur en cours de formatage a un chiffre à la position où le "#" apparaît dans la chaîne de formatage, alors ce chiffre est copié dans la chaîne de sortie. Sinon, rien n'est inclus à cette position dans la chaîne en sortie.
.	Séparateur décimal. Le premier caractère point "." dans la chaîne de format détermine l'emplacement du séparateur décimal dans la valeur formatée ; les caractères '.' supplémentaires sont ignorés. Le caractère effectivement utilisé comme séparateur décimal dans la chaîne en sortie est déterminé par la variable globale DecimalSeparator. La valeur par défaut de DecimalSeparator est spécifiée dans le format du nombre de la section Paramètres régionaux du Panneau de configuration Windows.
,	Séparateur des milliers. Si la chaîne de formatage contient au moins un caractère ",", la sortie aura des séparateurs des milliers insérés entre chaque groupe de trois chiffres situés à gauche de la virgule décimale. L'emplacement et le nombre de caractères "," dans la chaîne de formatage n'affecte pas la sortie, sauf pour indiquer que les séparateurs des milliers sont souhaités. Le caractère effectivement utilisé comme séparateur décimal dans la chaîne en sortie est déterminé par la variable globale ThousandSeparator. La valeur par défaut de ThousandSeparator est spécifiée dans le format du nombre de la section Paramètres régionaux du Panneau de configuration Windows.
E+	Notation scientifique. Si une des chaînes "E+", "E-", "e+" ou "e-" est contenue dans la chaîne de formatage, le nombre est formaté en utilisant la notation scientifique. Un groupe comprenant jusqu'à quatre caractères "0" peut suivre immédiatement le "E+", "E-", "e+" ou le "e-" afin de déterminer le nombre minimum de chiffres dans l'exposant. Les formats "E+" et "e+" affichera un signe plus en sortie pour les exposants positifs et un signe moins pour les exposants négatifs. Les formats "E-" et "e-" ont en sortie un caractère signé uniquement pour les exposants négatifs.
'xx'/"xx"	Les caractères encadrés par des guillemets simples ou doubles sont renvoyés tels quels et n'affectent pas le format.
;	Sépare les sections des nombres positifs, négatifs et nuls dans la chaîne de format.
c	La date dans le format indiqué par la variable globale ShortDateFormat, suivie de l'heure dans le format indiqué par la variable globale LongTimeFormat. L'heure n'est pas affichée si la partie fractionnaire de DateTime est égale à zéro.
d	Le jour sous forme de nombre non précédé par un zéro (1-31).
dd	Le jour sous forme de nombre précédé par un zéro (01-31).
ddd	Le jour sous forme d'une abréviation (Dim-Sam) en utilisant les chaînes indiquées par la variable globale ShortDayNames.
dddd	Le jour sous forme de nom complet (Dimanche-Samedi) en utilisant les chaînes indiquées par la variable globale LongDayNames.
ddddd	La date en utilisant le format indiqué par la variable globale ShortDateFormat.
dddddd	La date en utilisant le format indiqué par la variable globale LongDateFormat.
m	Le mois sous forme de nombre non précédé par un zéro (1-12). Si le spécificateur m suit immédiatement un spécificateur h ou hh, les minutes sont affichées plutôt que le numéro du mois.
mm	Le mois sous forme de nombre précédé par un zéro (01-12). Si le spécificateur mm suit immédiatement un spécificateur h ou hh, il provoque l'affichage des minutes plutôt que du numéro du mois.
mmm	Le mois sous forme d'une abréviation (Jan-Déc) en utilisant les chaînes indiquées par la variable globale ShortMonthNames.
mmmm	Le mois sous forme de nom complet (Janvier-Décembre) en utilisant les chaînes indiquées par la variable globale LongMonthNames.
yy	L'année sous forme de nombre à deux chiffres (00-99).
yyyy	L'année sous forme de nombre à quatre chiffres (0000-9999).
h	L'heure non précédée par un zéro (0-23).
hh	L'heure précédée par un zéro (00-23).
n	Les minutes non précédées par un zéro (0-59).
nn	Les minutes précédées par un zéro (00-59).
s	Les secondes non précédées par un zéro (0-59).
ss	Les secondes précédées par un zéro (00-59).
t	L'heure en utilisant le format indiqué par la variable globale ShortTimeFormat.
tt	L'heure en utilisant le format indiqué par la variable globale LongTimeFormat.
am/pm	L'heure sur 12 heures pour le spécificateur h ou hh précédant, suivie de "am" pour toutes les heures avant midi ou "pm" pour toutes les heures après midi. Le spécificateur am/pm peut utiliser indifféremment les majuscules ou les minuscules.
a/p	L'heure sur 12 heures pour le spécificateur h ou hh précédant, suivie de "a" pour toutes les heures avant midi ou "p" pour toutes les heures après midi. Le spécificateur a/p peut utiliser indifféremment des majuscules ou des minuscules ; l'affichage s'effectuera en conséquence
ampm	L'heure sur 12 heures pour le spécificateur h ou hh précédant, suivie du contenu de la variable globale TimeAMString pour toutes les heures avant midi et du contenu de la variable globale TimePMString pour toutes les heures après midi.
/	Le caractère de séparation de la date indiqué par la variable globale DateSeparator.
:	Le caractère de séparation d'heures indiqué par la variable globale TimeSeparator.
'xx'/"xx"	Les caractères compris entre apostrophes ou guillemets sont affichés tels quels, sans aucune modification de formatage.

Les emplacements du "0" le plus à gauche avant la virgule décimale et du "0" le plus à droite après la virgule décimale dans la chaîne de formatage déterminent le rang des chiffres qui sont toujours présents dans la chaîne de sortie.

Le nombre en cours de formatage est toujours arrondi à autant de chiffres décimaux qu'il y a d'emplacements de chiffres ("0" ou "#") à la droite de la virgule décimale. Si cette dernière ne contient pas de séparateur décimal, la valeur formatée est arrondie au nombre entier le plus proche.

Si le nombre en cours de formatage a plus de chiffres à la gauche du séparateur décimal qu'il n'y a d'emplacements de chiffres à la gauche du caractère "." dans la chaîne de formatage, les chiffres supplémentaires sont sortis avant le premier emplacement de chiffre.

La chaîne de format peut contenir une, deux ou trois sections séparées par des points-virgules pour autoriser des formats différents pour les valeurs positives, négatives et nulles.

Une section : la chaîne de format s'applique à toutes les valeurs.

Deux sections : la première section s'applique aux valeurs positives et nulles et la deuxième aux valeurs négatives.

Trois sections : la première section s'applique aux valeurs positives, la deuxième aux valeurs négatives, et la troisième aux valeurs nulles.

Si la section pour les valeurs négatives ou celle pour les valeurs zéro est vide, c'est-à-dire, s'il n'existe rien entre les points-virgules délimitant la section, celle pour les valeurs positives est utilisées à la place.

Si la section pour les valeurs positives est vide ou si la chaîne de formatage entière est vide, la valeur est formatée en utilisant le formatage général à virgule flottante avec 15 chiffres significatifs. Ce type de format est également utilisé si la valeur dispose de plus de 18 chiffres à gauche du séparateur décimal et si la chaîne de format n'indique pas la notation scientifique.

Quand ResultType a la valeur ftDate, ftTime ou ftDateTime, la valeur de DisplayFormat est une chaîne codant le formatage des données en utilisant les spécificateurs du tableau suivant:

Spécificateur	Affichage
c	La date dans le format indiqué par la variable globale ShortDateFormat, suivie de l'heure dans le format indiqué par la variable globale LongTimeFormat. L'heure n'est pas affichée si la partie fractionnaire de DateTime est égale à zéro.
d	Le jour sous forme de nombre non précédé par un zéro (1-31).
dd	Le jour sous forme de nombre précédé par un zéro (01-31).
ddd	Le jour sous forme d'une abréviation (Dim-Sam) en utilisant les chaînes indiquées par la variable globale ShortDayNames.
dddd	Le jour sous forme de nom complet (Dimanche-Samedi) en utilisant les chaînes indiquées par la variable globale LongDayNames.
ddddd	La date en utilisant le format indiqué par la variable globale ShortDateFormat.
dddddd	La date en utilisant le format indiqué par la variable globale LongDateFormat.
m	Le mois sous forme de nombre non précédé par un zéro (1-12). Si le spécificateur m suit immédiatement un spécificateur h ou hh, les minutes sont affichées plutôt que le numéro du mois.
mm	Le mois sous forme de nombre précédé par un zéro (01-12). Si le spécificateur mm suit immédiatement un spécificateur h ou hh, il provoque l'affichage des minutes plutôt que du numéro du mois.
mmm	Le mois sous forme d'une abréviation (Jan-Déc) en utilisant les chaînes indiquées par la variable globale ShortMonthNames.
mmmm	Le mois sous forme de nom complet (Janvier-Décembre) en utilisant les chaînes indiquées par la variable globale LongMonthNames.
yy	L'année sous forme de nombre à deux chiffres (00-99).
yyyy	L'année sous forme de nombre à quatre chiffres (0000-9999).
h	L'heure non précédée par un zéro (0-23).
hh	L'heure précédée par un zéro (00-23).
n	Les minutes non précédées par un zéro (0-59).
nn	Les minutes précédées par un zéro (00-59).
s	Les secondes non précédées par un zéro (0-59).
ss	Les secondes précédées par un zéro (00-59).
t	L'heure en utilisant le format indiqué par la variable globale ShortTimeFormat.
tt	L'heure en utilisant le format indiqué par la variable globale LongTimeFormat.
am/pm	L'heure sur 12 heures pour le spécificateur h ou hh précédant, suivie de "am" pour toutes les heures avant midi ou "pm" pour toutes les heures après midi. Le spécificateur am/pm peut utiliser indifféremment les majuscules ou les minuscules.
a/p	L'heure sur 12 heures pour le spécificateur h ou hh précédant, suivie de "a" pour toutes les heures avant midi ou "p" pour toutes les heures après midi. Le spécificateur a/p peut utiliser indifféremment des majuscules ou des minuscules ; l'affichage s'effectuera en conséquence
ampm	L'heure sur 12 heures pour le spécificateur h ou hh précédant, suivie du contenu de la variable globale TimeAMString pour toutes les heures avant midi et du contenu de la variable globale TimePMString pour toutes les heures après midi.
/	Le caractère de séparation de la date indiqué par la variable globale DateSeparator.
:	Le caractère de séparation d'heures indiqué par la variable globale TimeSeparator.
'xx'/"xx"	Les caractères compris entre apostrophes ou guillemets sont affichés tels quels, sans aucune modification de formatage.