System.SysUtils.FormatDateTime

• Aller au parent : System.SysUtils

Delphi

function FormatDateTime(const Format: string; DateTime: TDateTime): string;
function FormatDateTime(const Format: string; DateTime: TDateTime;
const AFormatSettings: TFormatSettings): string;

C++

extern DELPHI_PACKAGE System::UnicodeString __fastcall FormatDateTime(const System::UnicodeString Format, System::TDateTime DateTime)/* overload */;

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	System.SysUtils.pas System.SysUtils.hpp	System.SysUtils	System.SysUtils

Description

Formate une valeur TDateTime.

FormatDateTime formate la valeur TDateTime fournie par DateTime en utilisant le format indiqué par Format. Voir le tableau suivant pour obtenir des informations sur les chaînes de format supportées.

Si la chaîne spécifiée par le paramètre Format est vide, la valeur TDateTime est implicitement formatée avec le spécificateur de format 'c'.

La première forme de FormatDateTime n'est pas adaptée aux threads car elle utilise les informations de localisation contenues dans les variables globales. La seconde forme de FormatDateTime, qui est adaptée aux threads, fait référence aux informations de localisation contenues dans le paramètre AFormatSettings. Avant d'appeler la forme adaptée aux threads de FormatDateTime, vous devez placer les informations de localisation dans AFormatSettings. Pour placer un ensemble de valeurs locales par défaut dans AFormatSettings, appelez TFormatSettings.Create.

Les chaînes de Format de date Time sont composées de spécificateurs représentant les valeurs à insérer dans la chaîne formatée. Certains spécificateurs (tels que "d") formatent simplement des nombres ou des chaînes. D'autres spécificateurs (tels que "/") font référence à des chaînes spécifiques aux paramètres régionaux issues de variables globales.

Le tableau suivant présente les spécificateurs en lettres minuscules. La casse est ignorée dans les formats, sauf dans le cas des spécificateurs "am/pm" et "a/p".

Spécificateur	Affichage
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 valeur date-heure indique précisément minuit.
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.
e	(Windows uniquement) Affiche l'année de la période/ère en cours sous la forme d'un nombre, sans le préfixer d'un zéro (localisations japonaise, coréenne et taïwanaise seulement)
ee	(Windows uniquement) Affiche l'année de la période/ère en cours sous la forme d'un nombre, en le préfixant d'un zéro (localisations japonaise, coréenne et taïwanaise seulement)
g	(Windows uniquement) Affiche la période/ère sous la forme d'une abréviation (localisations japonaise, coréenne et taïwanaise seulement)
gg	(Windows uniquement) Affiche complètement la période/ère. (Localisations japonaise, coréenne et taïwanaise seulement)
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 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	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 des majuscules ou des minuscules ; l'affichage s'effectuera en conséquence
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 encadrés par des guillemets simples ou doubles sont affichés tels quels et n'affectent pas le formatage.

Voir aussi

• Routines de conversion des types

Exemples de code

• FormatDateTime (C++)
• FormatDateTime (Delphi)