FormatDateTime (rtl)
De Wiki1000
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 :
- c Affiche 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.
- d Affiche le numéro du jour sans le préfixer d'un zéro (1 à 31).
- dd Affiche le numéro du jour en le préfixant d'un zéro (01 à 31).
- ddd Affiche le jour abrégé (Dim à Sam) en utilisant les chaînes fournies par la variable globale ShortDayNames.
- dddd Affiche le jour complet (Dimanche à Samedi) en utilisant les chaînes fournies par la variable globale LongDayNames.
- ddddd Affiche la date en utilisant le format fourni par la variable globale ShortDateFormat.
- dddddd Affiche la date en utilisant le format fourni par la variable globale LongDateFormat.
- m Affiche 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.
- mm Affiche 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.
- mmm Affiche le mois abrégé (Jan à Déc) en utilisant les chaînes fournies par la variable globale ShortMonthNames.
- mmmm Affiche le mois complet (Janvier à Décembre) en utilisant les chaînes fournies par la variable globale LongMonthNames.
- yy Affiche le numéro de l'année sous la forme de deux chiffres (00 à 99).
- yyyy Affiche l'année sous la forme de quatre chiffres (0000-9999).
- h Affiche l'heure sans la préfixer d'un zéro (0 à 23).
- hh Affiche l'heure en la préfixant d'un zéro (00 à 23).
- n Affiche les minutes sans les préfixer d'un zéro (0 à 59).
- nn Affiche les minutes en les préfixant d'un zéro (00 à 59).
- s Affiche les secondes sans les préfixer d'un zéro (0 à 59).
- ss Affiche les secondes en les préfixant d'un zéro (00 à 59).
- z Affiche les millisecondes sans les préfixer d'un zéro (0 à 999).
- zzz Affiche les millisecondes en les préfixant d'un zéro (0 à 999).
- t Affiche l'heure en utilisant le format fourni par la variable globale ShortTimeFormat.
- tt Affiche l'heure en utilisant le format fourni par la variable globale LongTimeFormat.
- am/pm Utilise 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/p Utilise 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.
- ampm Utilise 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'.
Les constantes suivantes peuvent être utilisées :
| cShortDatetimeFormat | Format de date et heure court |
| cLongDatetimeFormat | Format de date et heure long |
| cShortDateFormat | Format de date court |
| cLongDateFormat | Format de date long |
| cShortTimeFormat | Format d'heure court |
| cLongTimeFormat | Format d'heure long |
|
Tip : Cette fonction prend en compte les paramètres de langue de l'utilisateur |
Exemple :
begin end;
Voir aussi:
