FormatDateHeure

Mise en forme d'une valeur TDateTime.

Structure

FormatDateTime(const Format : string ; DateTime : TDateTime) : string ;

Paramètres

Valeur de retour

Description

La fonction FormatDateTime met en forme la valeur TDateTime fournie par DateTime en utilisant le format spécifié par Format. Les spécificateurs de format suivants sont pris en charge :

Spécificateur c Affiche

c Affiche la date selon le format défini par la variable globale ShortDateFormat, suivie de l'heure selon le format défini par la variable globale LongTimeFormat. L'heure n'est pas affichée si la partie fractionnaire de la valeur DateTime est égale à zéro.

d Affiche le jour sous forme de chiffre sans zéro initial (1-31).

dd Affiche le jour sous forme de nombre précédé d'un zéro (01-31).

ddd Affiche le jour sous forme d'abréviation (dim-sam) en utilisant les chaînes fournies par la variable globale ShortDayNames.

dddd Affiche le jour sous sa forme complète (dimanche-samedi) en utilisant les chaînes fournies par la variable globale d'

s LongDayNames.

ddddd Affiche la date selon le format défini par la variable globale ShortDateFormat.

dddddd Affiche la date selon le format défini par la variable globale LongDateFormat.

m Affiche le mois sous forme de chiffre sans zéro initial (1-12). Si le code « m » suit immédiatement un code « h » ou « hh », c'est la minute qui s'affiche, et non le mois.

mm Affiche le mois sous forme de chiffre précédé d'un zéro (01-12). Si le spécificateur « mm » suit immédiatement un spécificateur « h » ou « hh », ce sont les minutes qui s'affichent, et non le mois.

mmm Affiche le mois sous forme d'abréviation (janv.-déc.) en utilisant les chaînes fournies par la variable globale ShortMonthNames.

Affiche le nom complet du mois (janvier-décembre) à l'aide des chaînes fournies par la variable globale LongMonthNames.

yy Affiche l'année sous la forme d'un nombre à deux chiffres (00-99).

yyyy Affiche l'année sous la forme d'un nombre à quatre chiffres (0000-9999).

h Affiche l'heure sans le zéro initial (0-23).

hh Affiche l'heure avec un zéro devant (00-23).

n Affiche les minutes sans le zéro initial (0-59).

Affiche les minutes avec un zéro devant (00-59).

Affiche les secondes sans zéro initial (0-59).

Affiche les secondes avec un zéro devant (00-59).

z Affiche la valeur en millisecondes sans zéro initial (0-999).

zzz Affiche la milliseconde précédée d'un zéro (000-999).

Affiche l'heure selon le format défini par la variable globale ShortTimeFormat.

Affiche l'heure selon le format défini par la variable globale LongTimeFormat.

am/pm Utilise le format de 12 heures pour le spécificateur h ou hh précédent, et affiche « am » pour toute heure avant midi, et « pm » pour toute heure après midi. Le spécificateur « am/pm » peut être écrit en minuscules, en majuscules ou en mélange de minuscules et majuscules, et le résultat s'affiche en conséquence.

a/p Utilise le format de 12 heures pour le spécificateur h ou hh précédent, et affiche « a » pour toute heure avant midi, et « p » pour toute heure après midi. Le spécificateur a/p peut être écrit en minuscules, en majuscules ou en mélange de minuscules et majuscules, et le résultat s'affiche en conséquence.

ampm utilise le format 12 heures pour le spécificateur h ou hh précédent, et affiche le contenu de la variable globale TimeAMString pour toute heure avant midi, et le contenu de la variable globale TimePMString pour toute heure après midi.

/ Affiche le caractère de séparation de date défini par la variable globale DateSeparator.

: Affiche le caractère de séparation de l'heure défini par la variable globale TimeSeparator.

Les caractères « xx »/« xx » placés entre guillemets simples ou doubles s'affichent tels quels et n'ont aucune incidence sur la mise en forme.

Les spécificateurs de format peuvent être écrits en majuscules ou en minuscules : les deux donnent le même résultat.

Si la chaîne spécifiée par le paramètre Format est vide, la valeur TDateTime est mise en forme comme si un spécificateur de format « c » avait été fourni. |