CTime::Format
Rufen Sie die Memberfunktion auf, um eine formatierte Darstellung des Datum-Zeit-Werts zu erstellen.
CString Format(
LPCTSTR pszFormat
) const;
CString Format(
UINT nFormatID
) const;
Parameter
pszFormat
Eine Formatierungszeichenfolge ähnlich der printf Formatierungszeichenfolge. Die Formatierungscodes voraus, von einem Zeichen des eine Prozent (%), werden durch die entsprechende CTime Komponente ersetzt. Andere Zeichen in der Formatierungszeichenfolge werden unverändert an die zurückgegebene Zeichenfolge kopiert. Siehe die Laufzeitfunktion strftime für eine Liste von Formatierungscodes.nFormatID
Die ID der Zeichenfolge, die dieses Formats.
Rückgabewert
CString, das die formatierte Zeit enthält.
Hinweise
Wenn der Status dieses Objekts CTime NULL ist, ist der Rückgabewert eine leere Zeichenfolge.
Diese Methode löst eine Ausnahme aus, wenn der zu formatieren DateTime-Wert nicht vom Mitternacht reicht, dem 1. Januar 1970 bis zum 31. Dezember 3000 koordinierte Weltzeit (UTC) aus.
Beispiel
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"));
Anforderungen
Header: atltime.h