COleDateTime::Format
Cria uma representação formatado do valor de data/hora.
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 sinalizadores da localidade:uso deLOCALE_NOUSEROVERRIDE as configurações de localidade padrão do sistema, em vez de configurações personalizados.
VAR_TIMEVALUEONLY ignora a parte de data durante a análise.
VAR_DATEVALUEONLY ignora a parte de tempo durante a análise.
lcid
Indica a identificação de localidade para usar a conversão.Para obter mais informações sobre identificadores de idioma, consulte Identificadores de linguagem.lpszFormat
Uma cadeia de caracteres de formatação semelhante a printf que formata a cadeia de caracteres.Cada código de formatação, precedido por um sinal de porcentagem (%), é substituído pelo componente correspondente de COleDateTime .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 mais informações.O valor e o significado de códigos de formatação para Format são:%H hora do dia atual
minutos de**%M** na hora atual
o segundo do minuto do atual**%S**
sinal de porcentagem de**%%**
nFormatID
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/hora.
Comentários
Se o status de esse objeto de COleDateTime é zero, o valor de retorno é uma cadeia de caracteres vazia.Se o status é inválido, a cadeia de caracteres de retorno é especificada pelo recurso ATL_IDS_DATETIME_INVALIDde cadeia de caracteres.
Uma breve descrição dos três formas para essa função maneira:
Format( dwFlags, lcid)
Este formulário formata o valor usando as especificações de idioma (identificações de localidade) pela data e hora.Usando parâmetros padrão, este formulário será impresso a data e hora, a menos que a parte de tempo é 0 (meia-noite), em esse caso será impresso apenas a data, ou a parte de data é 0 (30 de dezembro de 1899), em esse caso será impresso apenas o tempo.Se o valor de data/hora é 0 (30 de dezembro de 1899, meia-noite), este formulário com os parâmetros padrão será impresso a meia-noite.Format( lpszFormat)
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.Para obter mais informações sobre códigos de formatação, consulte strftime, wcsftime na referência da biblioteca em tempo de execução.Format( nFormatID)
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.Para obter mais informações sobre códigos de formatação, consulte strftime, wcsftime em Referência da biblioteca em tempo de execução.
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