Compartilhar via


CTimeSpan::Format

Gera uma cadeia de caracteres formatada que corresponde a esse CTimeSpan.

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

Parâmetros

  • pFormat, pszFormat
    Uma cadeia de caracteres de formatação semelhante a printf que formata a cadeia de caracteres. Códigos de formatação, precedido por um sinal de porcentagem (%), são substituídos pelo componente correspondente de CTimeSpan . Outros caracteres na cadeia de caracteres de formatação são inalteradas copiado para a cadeia de caracteres retornada. O valor e o significado de códigos de formatação para Formatar estão listados abaixo:

    • Dias do total de**%D** em este CTimeSpan

    • %H hora do dia atual

    • Minutos de**%M** na hora atual

    • o segundo do minuto do atual**%S**

    • Sinal de porcentagem %%

  • nID
    A identificação de cadeia de caracteres que identifica o formato.

Valor de retorno

Um objeto de CString que contém a hora formatadas.

Comentários

A versão de depuração de biblioteca verifica os códigos de formatação e afirmar-los se o código não está na lista anterior.

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

Requisitos

Cabeçalho: atltime.h

Consulte também

Referência

Classe de CTimeSpan

Gráfico da hierarquia