Data.DB.TSQLTimeStampField.DisplayFormat
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 | TSQLTimeStampField |
Description
Contrôle le formatage du champ date-heure SQL à des fins d'affichage.
DisplayFormat permet de spécifier la chaîne de formatage à utiliser pour formater la valeur d'un champ date-heure SQL quand la valeur du champ apparaît sous forme de chaîne. Si aucune chaîne n'a été affectée à DisplayFormat, la valeur est formatée selon le format de date-heure par défaut spécifié par le Panneau de configuration Windows.
Remarque : DisplayFormat n'affecte pas la valeur de la propriété AsString.
Pour construire une chaîne DisplayFormat, vous pouvez utiliser les spécificateurs de format suivants :
| 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. |
| mmmm | 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 spécificateurs de format peuvent être écrits en lettres majuscules ou minuscules ; ils produisent toujours le même résultat.
Si la chaîne spécifiée par le paramètre Format est vide, la valeur date-heure est formatée comme avec un spécificateur de format c.