Compartilhar via


CTime::Format

Chamar essa função de membro para criar uma representação formatado do valor de data e hora.

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

Parâmetros

  • 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 CTime .Outros caracteres na cadeia de caracteres de formatação são inalteradas copiado para a cadeia de caracteres retornada.Consulte a função strftime de tempo de execução para uma listagem de código de formatação.

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

Valor de retorno

CString que contém a hora formatadas.

Comentários

Se o status de esse objeto de CTime é zero, o valor de retorno é uma cadeia de caracteres vazia.

Este método gera uma exceção se o valor data-hora a formatação não varia da meia-noite, do 1º de janeiro de 1970 ao 31 de dezembro de 3000 universal coordinated time (UTC).

Exemplo

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

Requisitos

Cabeçalho: atltime.h

Consulte também

Referência

Classe de CTime

Gráfico de hierarquia

CTime::FormatGmt