Udostępnij za pośrednictwem


CTime::Format

Wywołanie tej funkcji Członkowskich do tworzenia sformatowanego reprezentacja wartości daty i godziny.

CString Format(
   LPCTSTR pszFormat 
) const;
CString Format(
   UINT nFormatID 
) const;

Parametry

  • pszFormat
    Formatowanie ciągu podobny do printf formatowania ciągu.Formatowanie kodów poprzedzone procent (%) podpisać, zastępuje odpowiednie CTime składnika.Inne znaki w ciągu formatowania są kopiowane bez zmian do zwrócony ciąg.Zobacz funkcja run-time strftime listę kody formatowania.

  • nFormatID
    Identyfikator ciąg, który identyfikuje ten format.

Wartość zwracana

A CString zawierający czasu sformatowany.

Uwagi

Jeśli stan to CTime obiektu jest null, zwracana jest wartość pusty ciąg.

Ta metoda zgłasza wyjątek, jeżeli wartość daty i godziny do formatowania nie należą do zakresu od północy 1 stycznia 1970 do dnia 31 grudnia 3000 Universal Coordinated Time (UTC).

Przykład

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

Wymagania

Nagłówek: atltime.h

Zobacz też

Informacje

Klasa CTime

Diagram hierarchii

CTime::FormatGmt