FormatDateTime (rtl)
Function FormatDateTime(const Format:String; DateTime:DateTime):String;
FormatDateTime convertit une valeur de type date en chaîne de caractère.
| Result | Valeur convertie. |
| Format | Format de conversion. |
| DateTime | Date à convertir. |
La valeur de la chaîne de format doit utiliser les spécificateurs suivants :
cAffiche la date, en utilisant le format défini par la variable globale ShortDateFormat, puis l'heure, en utilisant le format défini par la variable globale LongTimeFormat. L'heure n'est pas affichée si la partie fractionnaire de DateTime est égale à zéro.
dAffiche le numéro du jour sans le préfixer d'un zéro (1 à 31).
ddAffiche le numéro du jour en le préfixant d'un zéro (01 à 31).
dddAffiche le jour abrégé (Dim à Sam) en utilisant les chaînes fournies par la variable globale ShortDayNames.
ddddAffiche le jour complet (Dimanche à Samedi) en utilisant les chaînes fournies par la variable globale LongDayNames.
dddddAffiche la date en utilisant le format fourni par la variable globale ShortDateFormat.
ddddddAffiche la date en utilisant le format fourni par la variable globale LongDateFormat.
mAffiche le numéro du mois sans le préfixer d'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.
mmAffiche le numéro du mois en le préfixant d'un zéro (01 à 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.
mmmAffiche le mois abrégé (Jan à Déc) en utilisant les chaînes fournies par la variable globale ShortMonthNames.
mmmmAffiche le mois complet (Janvier à Décembre) en utilisant les chaînes fournies par la variable globale LongMonthNames.
yyAffiche le numéro de l'année sous la forme de deux chiffres (00 à 99).
yyyyAffiche l'année sous la forme de quatre chiffres (0000-9999).
hAffiche l'heure sans la préfixer d'un zéro (0 à 23).
hhAffiche l'heure en la préfixant d'un zéro (00 à 23).
nAffiche les minutes sans les préfixer d'un zéro (0 à 59).
nnAffiche les minutes en les préfixant d'un zéro (00 à 59).
sAffiche les secondes sans les préfixer d'un zéro (0 à 59).
ssAffiche les secondes en les préfixant d'un zéro (00 à 59).
zAffiche les millisecondes sans les préfixer d'un zéro (0 à 999).
zzzAffiche les millisecondes en les préfixant d'un zéro (0 à 999).
tAffiche l'heure en utilisant le format fourni par la variable globale ShortTimeFormat.
ttAffiche l'heure en utilisant le format fourni par la variable globale LongTimeFormat.
am/pmUtilise le format sur 12 heures avec le spécificateur h ou hh qui le précède et affiche 'am' pour les heures avant midi et 'pm' pour les heures après midi. Le spécificateur am/pm peut utiliser indifféremment les majuscules ou les minuscules.
a/pUtilise le format sur 12 heures avec le spécificateur h ou hh qui le précède et affiche 'a' pour les heures avant midi et 'p' pour les heures après midi. Le spécificateur a/p peut utiliser indifféremment les majuscules ou les minuscules.
ampmUtilise le format sur 12 heures avec le spécificateur h ou hh qui le précède et affiche le contenu de la variable globale TimeAMString pour les heures avant midi et le contenu de la variable globale TimePMString pour les heures après midi.
/Affiche le caractère de séparation de date fourni par la variable globale DateSeparator.
- Affiche le séparateur des heures fourni par la variable globale TimeSeparator.
'xx'/"xx"Les caractères compris entre des simples ou doubles guillemets sont affichés tels quels et n'affectent pas le format.
Les spécificateurs de format peuvent être indifféremment en majuscules ou en minuscules; le résultat obtenu est identique. Si la chaîne spécifiée par le paramètre Format est vide, l'objet TDateTime est implicitement formaté avec le spécificateur de format 'c'.
Exemple
begin end;
Voir aussi:
