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
Outros recursos
Date |
History |
Motivo |
|---|---|---|
|
Julho de 2008 |
Atualizada a constante de recurso de seqüência de caracteres para um status inválido. |
Correção de bug do conteúdo. |