COleDateTimeSpan::Format

Článek
03/04/2013

Vygeneruje formátovaný řetězec reprezentace COleDateTimeSpan objektu.

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

Parametry

pFormat
Řetězec formátování, podobně jako printf formátování řetězce.Formátovací kódy, které předchází procenta (%) podepsat, nahrazují odpovídající COleDateTimeSpan komponent.Ostatní znaky v řetězci formátování zkopírovány nezměněny vráceného řetězce.Hodnotu a význam formátovací kódy pro Formát jsou uvedeny níže:
- : %H hodin v aktuální den
- %M minut v aktuální hodinu
- %S sekund v aktuální minuta
- %% Znak procent
Výše uvedené čtyři kódy jsou pouze kódy, které budou přijímat formátu.
nID
ID zdroje řetězce formátu řízení.

Vrácená hodnota

A CString , který obsahuje datum, čas rozpětí formátované hodnoty.

Poznámky

Volejte tyto funkce k vytvoření formátované reprezentace hodnota časového rozsahu.Pokud tento stav COleDateTimeSpan objekt má hodnotu null, je vrácena hodnota prázdný řetězec.Pokud stav je neplatná, vráceného řetězce určený prostředek řetězce IDS_INVALID_DATETIMESPAN.

Stručný popis formuláře pro tuto funkci následujícím způsobem:

Format( pFormat )
Tento formulář formátuje hodnoty pomocí formátu řetězec, který obsahuje speciální formátovací kódy, které předchází znak procenta (%), jako v printf .Formátovací řetězec je předán jako parametr funkce.
Format( nID )
Tento formulář formátuje hodnoty pomocí formátu řetězec, který obsahuje speciální formátovací kódy, které předchází znak procenta (%), jako v printf .Formátovací řetězec je zdroj.ID zdroje řetězec je předán jako parametr.

Příklad

// get the current time
COleDateTime tmStart = COleDateTime::GetCurrentTime();

// waste some time
CString str;
::Sleep(3000);

// get the current time again
COleDateTime tmFinish = COleDateTime::GetCurrentTime();

// find the difference
COleDateTimeSpan tmSpan = tmFinish - tmStart;

// tell the user
str = tmSpan.Format(_T("%S seconds elapsed"));
_tprintf_s(_T("%s\n"), (LPCTSTR) str);