COleDateTimeSpan::Format

Artigo
08/25/2010

Gera uma representação de seqüência de caracteres formatada de um COleDateTimeSpan objeto.

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

Parâmetros

pFormat
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 COleDateTimeSpan 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:
- %H Horas no dia corrente
- %M Minutos na hora corrente
- %S Segundos do minuto corrente
- %% Sinal de porcentagem
Os códigos de formato de quatro listados acima são os únicos códigos que formatar aceitará.
nID
A ID do recurso para a seqüência de caracteres de controle de formato.

Valor de retorno

A CString que contém o valor de intervalo de data/time formatado.

Comentários

Chame essas funções para criar uma representação do valor de intervalo de time formatada.Se o status deste COleDateTimeSpan o objeto é nulo, o valor retornado é uma seqüência de caracteres vazia. Se o status for inválido, a seqüência de retorno é especificada pelo recurso de seqüência de caracteres IDS_INVALID_DATETIMESPAN.

Segue uma breve descrição de formulários para esta função:

(Formato pFormat )
Este formulário formata o valor usando a seqüência de caracteres de formato contém códigos de formatação especial que estiverem precedidos por um sinal de porcentagem (%), sistema autônomo em printf. A seqüência de caracteres de formatação é passada sistema autônomo um parâmetro para a função.
(Formato nID )
Este formulário formata o valor usando a seqüência de caracteres de formato contém códigos de formatação especial que estiverem precedidos por um sinal de porcentagem (%), sistema autônomo em printf. A cadeia de caracteres de formatação é um recurso.A ID do recurso seqüência de caracteres é passada sistema autônomo o parâmetro.

Para obter uma lista de valores de ID de localidade, consulte a seção Suporte a vários idiomas nacionais in the Windows SDK.

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