COleDateTime::ParseDateTime

Artigo
02/25/2013

Analisa uma cadeia de caracteres para ler um valor de data/hora.

bool ParseDateTime(
   LPCTSTR lpszDate,
   DWORD dwFlags = 0,
   LCID lcid = LANG_USER_DEFAULT 
) throw( );

Parâmetros

lpszDate
Um ponteiro para a cadeia de caracteres NULL- finalizada que deve ser analisada.Para obter detalhes, consulte comentários.
dwFlags
Indica os sinalizadores para configurações de localidade e análise.Um ou mais das seguintes sinalizações:
- 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.

Valor de retorno

Retorna true se a cadeia de caracteres com êxito ter sido convertido em um valor de data/hora, se não false.

Comentários

Se a cadeia de caracteres com êxito ter sido convertido em um valor de data/hora, o valor de esse objeto de COleDateTime é definido como o valor e seu status para válido.

Observação
Os valores do ano devem encontrar-se entre 100 e 9999, inclusiva.

O parâmetro de lpszDate pode ter uma variedade de formatos.Por exemplo, as seguintes cadeias de caracteres contiverem aceitáveis formatos de data/hora:

"25 January 1996"

"8:30:00"

"20:30:00"

"January 25, 1996 8:30:00"

"8:30:00 Jan. 25, 1996"

"1/25/1996 8:30:00" // always specify the full year,

// even in a 'short date' format

Observe que a ID local também afetará se o formato de cadeia de caracteres é aceitável para a conversão em um valor de data/hora.

Em o caso de VAR_DATEVALUEONLY, o valor de tempo é definido para cronometrar 0, ou meia-noite.Em o caso de VAR_TIMEVALUEONLY, o valor de data é definido até agora 0, significando o 30 de dezembro de 1899.

Se a cadeia de caracteres não pode ser convertido em um valor de data/hora ou se houver um estouro numérico, o status de esse objeto de COleDateTime é inválido.

Para obter mais informações sobre limites e implementação para valores de COleDateTime , consulte o artigo Data e hora: Suporte de automação.