COleDateTimeSpan::Format

Artykuł
02/27/2013

Generuje reprezentacja sformatowany ciąg COleDateTimeSpan obiektu.

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

Parametry

pFormat
Formatowanie ciągu podobny do printf formatowania ciągu.Formatowanie kodów poprzedzone procent (%) podpisać, zastępuje odpowiednie COleDateTimeSpan składnika.Inne znaki w ciągu formatowania są kopiowane bez zmian do zwrócony ciąg.Wartość i znaczenie kody formatowania dla Format są wymienione poniżej:
- %H godzin w dniu bieżącym
- %M minut w bieżącej godziny
- %S sekund Bieżąca minuta
- %% Znak procentu
Czterech kodów formatów wymienione powyżej są tylko kody, które akceptują Format.
nID
Identyfikator zasobu ciągu formatu formantu.

Wartość zwracana

A CString zawierający sformatowana wartość daty rozpiętość.

Uwagi

Wywołania tych funkcji do tworzenia sformatowanego reprezentacja wartości zakresu czasu.Jeśli stan to COleDateTimeSpan obiektu jest null, zwracana jest wartość pusty ciąg.Jeśli stan jest nieprawidłowy, zwracanego ciągu jest określony przez zasób ciąg IDS_INVALID_DATETIMESPAN.

Krótki opis formularzy dla tej funkcji jest następujący:

Format( pFormat )
Ten formularz formatuje wartości przy użyciu ciąg formatu, który zawiera specjalne kody formatowania, które są poprzedzone znakiem procentu (%), jak w printf.Ciąg znaków formatowania jest przekazywana jako parametr do funkcji.
Format( nID )
Ten formularz formatuje wartości przy użyciu ciąg formatu, który zawiera specjalne kody formatowania, które są poprzedzone znakiem procentu (%), jak w printf.Ciąg znaków formatowania jest zasobem.Identyfikator zasobu ten ciąg jest przekazywana jako parametr.

Przykład

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