Partager via


CTime::Format

Appelez la fonction membre pour créer une représentation mise en forme de la valeur datetime.

CString Format(
   LPCTSTR pszFormat 
) const;
CString Format(
   UINT nFormatID 
) const;

Paramètres

  • pszFormat
    Une chaîne de mise en forme semblable à printf forme la chaîne. Les codes de mise en forme, précédés par un pourcentage (%archivent), sont substitués par le composant correspondant d' CTime . 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 obtenir la liste des codes de mise en forme.

  • nFormatID
    L'ID de la chaîne qui identifie le format.

Valeur de retour

CString qui contient le temps mis en forme.

Notes

Si l'état de cet objet d' CTime est null, la valeur de retour est une chaîne vide.

Cette méthode lève une exception si la valeur datetime en forme ne s'étend pas de minuit, du 1er janvier 1970 au 31 décembre 3000 temps UTC (UTC).

Exemple

CTime t(1999, 3, 19, 22, 15, 0); 
// 10:15 PM March 19, 1999
CString s = t.Format(_T("%A, %B %d, %Y"));
ATLASSERT(s == _T("Friday, March 19, 1999"));   

Configuration requise

En-tête : atltime.h

Voir aussi

Référence

CTime, classe

Graphique de la hiérarchie

CTime::FormatGmt