CTimeSpan::Format

Generiert eine formatierte Zeichenfolge, die diesem CTimeSpan entspricht.

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

Parameter

• pFormat, pszFormat
  Eine Formatierungszeichenfolge ähnlich der printf Formatierungszeichenfolge.Die Formatierungscodes voraus, von einem Zeichen des eine Prozent (%), werden durch die entsprechende CTimeSpan Komponente ersetzt.Andere Zeichen in der Formatierungszeichenfolge werden unverändert an die zurückgegebene Zeichenfolge kopiert.Der Wert und die Bedeutung der Formatierungscodes für Format sind nachfolgend aufgeführt:

  • %D Gesamttage in diesem CTimeSpan

  • %H Stunden im aktuellen Tag

  • %M Minuten in der laufenden Stunde

  • %S Sekunden in der Stromminute

  • %%- Prozentzeichen

• nID
  Die ID der Zeichenfolge, die dieses Formats.

Rückgabewert

Ein CString-Objekt, das die formatierte Zeit enthält.

Hinweise

Die Debugversion der Bibliothek überprüft die Formatierungscodes und Assertionen, wenn der Code nicht in der Liste oben ist.

Beispiel

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"));   

Anforderungen

Header: atltime.h

Siehe auch

Referenz

CTimeSpan-Klasse

Hierarchien-Diagramm