COleDateTime::ParseDateTime

Artigo
08/25/2010

Analisa uma seqüência de caracteres para ler um Data/time valor.

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

Parâmetros

lpszDate
Um ponteiro para a seqüência de caracteres terminada com nulo que deve ser analisada.Para obter detalhes, consulte comentários.
dwFlags
Indica os sinalizadores para as configurações de localidade e analisar.Um ou mais dos sinalizadores a seguir:
- 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.

Valor de retorno

RetornaTrue se a seqüência de caracteres foi convertida com êxito para uma data / valor temporal, caso contrário, False.

Comentários

Se a seqüência de caracteres foi convertida com êxito para um valor de data/time, o valor de esseCOleDateTime objeto é definido como esse valor e seu status para válido.

Observação:
Valores de ano devem estar entre 100 e 9999, inclusive.

The lpszDate parâmetro pode ter uma variedade de formatos. Por exemplo, as seqüências de caracteres a seguintes contêm formatos de data/time aceitável:

"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 de local também afetará se o formato da seqüência de caracteres é aceitável para a conversão para uma data / valor temporal.

No caso de VAR_DATEVALUEONLY, o valor de time é conjunto para hora 0 ou meia-noite.No caso de VAR_TIMEVALUEONLY, o valor de data está definido como data 0, ou seja, 30 de dezembro de 1899.

Se a seqüência de caracteres não pôde ser convertida para um valor de data/time ou se houve um estouro numérico, o status deste COleDateTime o objeto é inválido.

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

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