COleDateTime::Format

Cria uma representação de formatada a Data/time valor.

CString Format(
   DWORD dwFlags = 0,
   LCID lcid = LANG_USER_DEFAULT
) const;
CString Format(
   LPCTSTR lpszFormat 
) const;
CString Format(
   UINT nFormatID 
) const;

Parâmetros

• dwFlags
  Indica um dos seguintes sinalizadores de localidade:

  • LOCALE_NOUSEROVERRIDE   Use as configurações de localidade do sistema padrão, em vez das configurações personalizadas do usuário.

  • VAR_TIMEVALUEONLY   ignorar a parte data durante a análise.

  • VAR_DATEVALUEONLY   ignorar a parte do time durante a análise.

• lcid
  Indica a ID de localidade a ser usada para a conversão.Para obter mais informações sobre identificadores de linguagem, consulte Identificadores de linguagem.

• lpszFormat
  Uma seqüência de formatação semelhante a printf seqüência de caracteres de formatação. Cada código de formatação, precedido por um percentual (%) assinar, é substituído pelo correspondente COleDateTime componente. Outros caracteres na seqüência de formatação são copiados a seqüência de caracteres retornada inalterada.Consulte o em time de execução funcionar STRFTIME para obter mais informações.O valor e o significado dos códigos de formatação para Format são:

  • %H   Horas no dia corrente

  • %M   Minutos na hora corrente

  • %S   Segundos do minuto corrente

  • %%   Sinal de porcentagem

• nFormatID
  A ID do recurso para a seqüência de caracteres de controle de formato.

Valor de retorno

A CString que contém a data formatada / valor temporal.

Comentários

Se o status deste COleDateTime 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 ATL_IDS_DATETIME_INVALID.

Segue uma breve descrição de três formas para esta função:

• Format( dwFlags, lcid)
  Este formulário formata o valor usando as especificações de linguagem nacional (identificações de localidade) para data e time.Usando os parâmetros padrão, este formulário imprimirão a data e time, a menos que a parte de time é 0 (meia-noite), caso em que ele será impresso apenas a data ou a parte de data é 0 (30 de dezembro de 1899) em que, nesse caso, ele será impresso apenas o time.Se o valor de data/time é 0 (30 de dezembro de 1899 meia-noite), este formulário com os parâmetros padrão serão impressos à meia-noite.

• Format( lpszFormat)
  Este formulário formata o valor usando a seqüência de caracteres de formato que 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.Para obter mais informações sobre os códigos de formatação, consulte STRFTIME, wcsftime na biblioteca em time de execução Reference.

• Format( nFormatID)
  Este formulário formata o valor usando a seqüência de caracteres de formato que 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 mais informações sobre os códigos de formatação, consulte STRFTIME, wcsftime in the Referência da biblioteca de time de execução.

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

COleDateTime t(1999, 3, 19, 22, 15, 0);

CString str = t.Format(_T("%A, %B %d, %Y"));
ASSERT(str == _T("Friday, March 19, 1999"));   

Requisitos

Cabeçalho: atlcomtime.h

Consulte também

Referência

Classe COleDateTime

Gráfico de hierarquia

COleDateTime::ParseDateTime

COleDateTime::GetStatus

Outros recursos

COleDateTime membros