COleDateTime::Format
Erstellt eine formatierte Darstellung des Datum-/Uhrzeitwerten.
CString Format(
DWORD dwFlags = 0,
LCID lcid = LANG_USER_DEFAULT
) const;
CString Format(
LPCTSTR lpszFormat
) const;
CString Format(
UINT nFormatID
) const;
Parameter
dwFlags
Gibt eines der folgenden Gebietsschemaflags an:LOCALE_NOUSEROVERRIDE verwendet die Systemstandard-Gebietsschemaeinstellungen, anstelle von benutzerdefinierten Benutzereinstellungen.
VAR_TIMEVALUEONLY ignorieren den Datumsteil während der Analyse.
VAR_DATEVALUEONLY ignorieren den Zeitteil während der Analyse.
lcid
Gibt Gebietsschema-ID an, die für die Konvertierung zu verwenden.Weitere Informationen zu Sprachen-ID, finden Sie unter Sprachbezeichner.lpszFormat
Eine Formatierungszeichenfolge ähnlich der printf Formatierungszeichenfolge.Jeder Formatierungscode voraus, von einem Zeichen des eine Prozent (%), wird durch die entsprechende COleDateTime Komponente ersetzt.Andere Zeichen in der Formatierungszeichenfolge werden unverändert an die zurückgegebene Zeichenfolge kopiert.Siehe die Laufzeitfunktion strftime weitere Informationen.Der Wert und die Bedeutung der Formatierungscodes für Format sind:%H Stunden im aktuellen Tag
%M Minuten in der laufenden Stunde
%S Sekunden in der Stromminute
%% Prozentzeichen
nFormatID
Das Ressourcen-ID für die Formatsteuerzeichenfolge.
Rückgabewert
CString, das den formatierten Datums-/Uhrzeitwert enthält.
Hinweise
Wenn der Status dieses Objekts COleDateTime NULL ist, ist der Rückgabewert eine leere Zeichenfolge.Wenn der Status ungültig ist, wird die Rückgabezeichenfolge durch die Zeichenfolgenressource ATL_IDS_DATETIME_INVALID angegeben.
Eine kurze Beschreibung der drei Formen für diese Funktion aus:
Format( dwFlags, lcid)
Dieses Formular formatiert den Wert, indem die Sprachenspezifikation (Gebietsschema IDs) für Datum und Uhrzeit verwendet.Verwenden der Standardparameter, gibt dieses Formular das Datum und die Uhrzeit, es sei denn, der Zeitteil 0 (Mitternacht) ist, in diesem Fall wird nur das Datum gibt oder der Datumsteil 0 (30. Dezember 1899) ist, in diesem Fall wird nur die Zeit gedruckt wird.Wenn der Datums-/Uhrzeitwert 0 (30. Dezember 1899, Mitternacht) ist, gibt dieses Formular mit den Standardparametern Mitternacht.Format( lpszFormat)
Dieses Formular formatiert den Wert, indem die Formatzeichenfolge verwendet, die spezielle Formatierungscodes enthält, die von einem Prozentzeichen (%) vorangestellt werden, wie in printf.Die Formatierungszeichenfolge wird als Parameter an die Funktion übergeben.Weitere Informationen über die Formatierungscodes, strftime, wcsftime finden Sie unter in der Laufzeitbibliotheksreferenz.Format( nFormatID)
Dieses Formular formatiert den Wert, indem die Formatzeichenfolge verwendet, die spezielle Formatierungscodes enthält, die von einem Prozentzeichen (%) vorangestellt werden, wie in printf.Die Formatierungszeichenfolge ist eine Ressource.Die ID dieser Zeichenfolgenressource wird als - Parameter übergeben.Weitere Informationen über die Formatierungscodes, finden Sie unter strftime, wcsftime in der Laufzeitbibliotheksreferenz.
Beispiel
COleDateTime t(1999, 3, 19, 22, 15, 0);
CString str = t.Format(_T("%A, %B %d, %Y"));
ASSERT(str == _T("Friday, March 19, 1999"));
Anforderungen
Header: atlcomtime.h