COleDateTime::Format
Vytvoří formátovaný vyjádření hodnoty data a času.
CString Format(
DWORD dwFlags = 0,
LCID lcid = LANG_USER_DEFAULT
) const;
CString Format(
LPCTSTR lpszFormat
) const;
CString Format(
UINT nFormatID
) const;
Parametry
dwFlags
Určuje jeden z následujících příznaků: národní prostředí:LOCALE_NOUSEROVERRIDEVlastní uživatelské nastavení použijte nastavení národního prostředí systému.
VAR_TIMEVALUEONLYIgnorujte datum část během analýzy.
VAR_DATEVALUEONLYIgnorujte časové části během analýzy.
lcid
Označuje ID národního prostředí pro převod.Další informace o identifikátorech jazyků naleznete v Identifikátory jazyka.lpszFormat
Formátování řetězce podobné printf formátování řetězce.Každý kód předchází procento formátování (%) podepsat, nahrazuje odpovídající COleDateTime komponenty.Ostatní znaky v řetězci formátování zkopírovány nezměněny vráceného řetězce.Spuštění funkce strftime Další informace.Hodnotu a význam formátování kódy pro Format jsou:%HHodin v aktuální den
%MMinut v aktuální hodinu.
%SAktuální minuty: sekundy
**%%**Znak procenta
nFormatID
ID zdroje prvek formátu řetězce.
Vrácená hodnota
A CString , který obsahuje hodnoty formátované datum a čas.
Poznámky
Pokud tento stav COleDateTime objekt je null, vrácená hodnota je prázdný řetězec.Pokud je neplatný stav, návratový řetězec určený prostředek řetězce ATL_IDS_DATETIME_INVALID.
Následuje stručný popis tří formulářů pro tuto funkci:
Format( dwFlags, lcid)
Tento formulář formáty pro datum a čas hodnoty pomocí specifikace jazyka (ID národního prostředí).Použití výchozích parametrů, tento formulář vytiskne datum a čas, pokud časové části je 0 (půlnoc), v takovém případě budou vytištěny pouze datum nebo část je 0 (30. prosince 1899) v takovém případě budou vytištěny pouze čas.Pokud je datum a čas hodnota 0 (30. prosince 1899, půlnoc), vytiskne tento formulář s výchozími parametry půlnoc.Format( lpszFormat)
Tento formulář formátuje hodnotu pomocí formátovací řetězec, který obsahuje speciální formátování kódy, které předchází znak procenta (%), jako v printf.Formátovací řetězec je předán jako parametr funkce.Další informace o formátování kódy viz strftime, wcsftime v Run-Time Library Reference.Format( nFormatID)
Tento formulář formátuje hodnotu pomocí formátovací řetězec, který obsahuje speciální formátování kódy, které předchází znak procenta (%), jako v printf.Formátovací řetězec je zdroj.ID prostředku tento řetězec je předán jako parametr.Další informace o formátování kódy viz strftime, wcsftime v Run-Time Library Reference.
Příklad
COleDateTime t(1999, 3, 19, 22, 15, 0);
CString str = t.Format(_T("%A, %B %d, %Y"));
ASSERT(str == _T("Friday, March 19, 1999"));
Požadavky
Záhlaví: atlcomtime.h