COleDateTimeSpan::Format

Artigo
02/25/2013

Produz uma representação de cadeia de caracteres formatada de um objeto de COleDateTimeSpan .

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

Parâmetros

pFormat
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 COleDateTimeSpan .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:
- %H hora do dia atual
- Minutos de**%M** na hora atual
- o segundo do minuto do atual**%S**
- Sinal de porcentagem %%
Os quatro códigos de formato listados acima são os únicos códigos que o formato aceitará.
nID
A identificação de recurso para a cadeia de caracteres de formato - controle.

Valor de retorno

CString que contém o valor formatado de data/período.

Comentários

Chamar essas funções para criar uma representação formatado do valor do período.Se o status de esse objeto de COleDateTimeSpan é zero, o valor de retorno é uma cadeia de caracteres vazia.Se o status é inválido, a cadeia de caracteres de retorno é especificada pelo recurso IDS_INVALID_DATETIMESPANde cadeia de caracteres.

Uma breve descrição de formulários para essa função maneira:

Format( pFormat )
Este formulário formata o valor usando a cadeia de caracteres de formato que contém os códigos de formatação especial que são precedidos por um sinal de porcentagem (%), como em printf.A cadeia de caracteres de formatação é passado como um parâmetro para a função.
Format( nID )
Este formulário formata o valor usando a cadeia de caracteres de formato que contém os códigos de formatação especial que são precedidos por um sinal de porcentagem (%), como em printf.A cadeia de caracteres de formatação é um recurso.A identificação de este recurso de cadeia de caracteres é passado como o parâmetro.

Exemplo

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