Partager via


CTimeSpan::Format

Génère une chaîne mise en forme qui correspond à cet CTimeSpan.

CString Format( 
   LPCSTR pFormat  
) const; 
CString Format( 
   LPCTSTR pszFormat  
) const; 
CString Format( 
   UINT nID  
) const;

Paramètres

  • pFormat, 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' CTimeSpan . D'autres caractères dans la chaîne de format sont copiés inchangés à la chaîne retournée. La valeur et la signification des codes de mise en forme pour Format sont répertoriées ci-dessous :

    • Jours de total de**%D** dans cet CTimeSpan

    • Heures de**%H** dans le jour actuel

    • Minutes de**%M** dans l'heure actuelle

    • Secondes de**%S** dans la minute actuelle

    • Signe de pourcentage de %%

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

Valeur de retour

Un objet d' CString qui contient le temps mis en forme.

Notes

La version debug de la bibliothèque contrôle les codes et les assertions de mise en forme si le code n'est pas dans la liste ci-dessus.

Exemple

CTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
CString s = ts.Format(_T("Total days: %D, hours: %H, mins: %M, secs: %S"));
ATLASSERT(s == _T("Total days: 3, hours: 01, mins: 05, secs: 12"));   

Configuration requise

Header: atltime.h

Voir aussi

Référence

CTimeSpan, classe

Graphique de la hiérarchie