CTimeSpan::Format

Gera uma seqüência de caracteres formatada que corresponde a este CTimeSpan.

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

Parâmetros

pFormat, pszFormat
Uma seqüência de formatação semelhante a printf seqüência de caracteres de formatação. Códigos de formatação, precedidos por um percentual (%) assinar, são substituídos por correspondente CTimeSpan componente. Outros caracteres na seqüência de formatação são copiados a seqüência de caracteres retornada inalterada.O valor e o significado dos códigos de formatação para Formato abaixo:
- %D Total de dias neste CTimeSpan
- %H Horas no dia corrente
- %M Minutos na hora corrente
- %S Segundos do minuto corrente
- %% Sinal de porcentagem
nID
A ID da cadeia de caracteres que identifica este formato.

Valor de retorno

A CString objeto que contém o time formatado.

Comentários

Versão de depurar de biblioteca verifica os códigos de formatação e declarações se o código não estiver na lista acima.

Exemplo

CTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
CString s = ts.Format(_T("Total days: %D, hours: %H, mins: %M, secs: %S"));
ATLASSERT(s == _T("Total days: 3, hours: 01, mins: 05, secs: 12"));