COleDateTime::Format
Crée une représentation mise en forme de valeur de date/d'heure.
CString Format(
DWORD dwFlags = 0,
LCID lcid = LANG_USER_DEFAULT
) const;
CString Format(
LPCTSTR lpszFormat
) const;
CString Format(
UINT nFormatID
) const;
Paramètres
dwFlags
Indique une des balises suivantes de paramètres régionaux :Utilisation d'LOCALE_NOUSEROVERRIDE les paramètres régionaux par défaut du système, au lieu des paramètres utilisateur personnalisés.
VAR_TIMEVALUEONLY ignorent la partie de dates pendant l'analyse.
VAR_DATEVALUEONLY ignorent la partie horaire pendant l'analyse.
lcid
Indique l'ID de paramètres régionaux à utiliser pour la conversion. Pour plus d'informations sur les ID de langue, consultez l' ID de langue.lpszFormat
Une chaîne de mise en forme semblable à printf forme la chaîne. Chaque code de mise en forme, précédé par un pourcentage (%archivent), est remplacé par le composant correspondant d' COleDateTime . D'autres caractères dans la chaîne de format sont copiés inchangés à la chaîne retournée. Consultez la fonction runtime strftime pour plus d'informations. La valeur et la signification des codes de mise en forme pour Format sont :Heures d'%H dans le jour actuel
Minutes d'%M dans l'heure actuelle
Secondes d'%S dans la minute actuelle
Signe de pourcentage d'%%
nFormatID
L'ID de ressource pour la chaîne de format.
Valeur de retour
CString qui contient la valeur de date/d'heure mis en forme.
Notes
Si l'état de cet objet d' COleDateTime est null, la valeur de retour est une chaîne vide. Si le mode est incorrect, la chaîne de retour est spécifiée par la ressource de type chaîne ATL_IDS_DATETIME_INVALID.
Une brève description des trois formes pour cette fonction suivante :
Format( dwFlags, lcid)
Ce formulaire met en forme la valeur à l'aide de les spécifications du langage (ID de paramètres régionaux) pour la date et d'heure. À l'aide de les paramètres par défaut, ce formulaire imprimera la date et l'heure, à moins que la partie horaire a 0 ans (minuit), auquel cas il imprimera uniquement la date, ou la partie de date a 0 ans (30 décembre 1899), auquel cas il imprimera simplement le temps. Si la valeur de date/d'heure est 0 (30 décembre 1899, minuit), cette forme avec les paramètres par défaut imprimera minuit.Format( lpszFormat)
Ce formulaire met en forme la valeur à l'aide de la chaîne de format qui contient les codes de mise en forme spéciaux qui sont précédés par un signe de pourcentage (%), comme dans printf. La chaîne de mise en forme est passée comme paramètre à la fonction. Pour plus d'informations sur les codes de mise en forme, consultez strftime, wcsftime dans la référence de la bibliothèque Runtime.Format( nFormatID)
Ce formulaire met en forme la valeur à l'aide de la chaîne de format qui contient les codes de mise en forme spéciaux qui sont précédés par un signe de pourcentage (%), comme dans printf. La chaîne de mise en forme est une ressource. L'ID de cette ressource de type chaîne passée comme paramètre. Pour plus d'informations sur les codes de mise en forme, consultez strftime, wcsftime dans Référence de la bibliothèque Runtime.
Exemple
COleDateTime t(1999, 3, 19, 22, 15, 0);
CString str = t.Format(_T("%A, %B %d, %Y"));
ASSERT(str == _T("Friday, March 19, 1999"));
Configuration requise
en-tête : atlcomtime.h