COleDateTime::ParseDateTime

BOOL ParseDateTime (LPCTSTR lpszDate, DWORD dwFlags = 0,LCID lcid = LANG_USER_DEFAULT);
lançar (CMemoryException);
lançar (COleException);

Valor de retorno

Diferente de zero se a Cadeia de caracteres foi convertida com êxito para um valor de data/hora, caso contrário, 0.

Parâmetros

lpszDate

Um ponteiro para o seqüência de caracteres null-terminated que está a ser analisado. Para obter detalhes, consulte "Comentários".

dwFlags

Indica os sinalizadores de configurações de localidade e de análise. Um ou mais dos sinalizadores a seguir:

lcid

Indica a identificação da localidade a ser usado para a conversão.

Observações

Chame essa função de membro para analisar uma Cadeia de caracteres para ler um valor de data/hora. Se a Cadeia de caracteres foi convertida com êxito para um valor de data/hora, o valor deste objeto COleDateTime é definido como esse valor e seu status para válido.

&Notanbsp;  Valores de ano devem estar entre 100 e 9999, inclusive.

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

"25 De Ja&neiro de 1996"
"8: 30:00"
"20: 30:00"
"25 De Janeiro de 1996 8:30:00"
"8: 30:00 25 De Janeiro de 1996"
"25/01/1996 8:30:00" nbsp; / / sempre especificar o ano inteiro,
                     / / mesmo em um formato de 'data de curto'

Observe que o ID de localidade também irá afetar se o Formatarar de Cadeia de caracteres é aceitável para a conversão para um valor de data/hora.

No caso de VAR_DATEVALUEONLY, o valor de tempo é definido como 0, ou meia-noite tempo. No caso de VAR_TIMEVALUEONLY, o valor de data é definido como data 0, significando 30 de Dezembro de 1899.

Se a Cadeia de caracteres não pôde ser convertida para um valor de data/hora ou se houve um estouro numérico, o status do objeto COleDateTime é inválido.

Se a conversão de Cadeia de caracteres falha devido a erros de alocação de memória, essa função lança um CMemoryException. Em qualquer outro Estado de erro, essa função lança um COleException.

Para obter uma lista de valores de ID de localidade, consulte a seção Suporte Múltiplo idiomas nacionais in the Win32 SDK OLE Programmer Referência.

Para obter mais informações sobre os limites e a implementação para valores de COleDateTime , consulte o artigo a data e hora: automação de suporte no Guia do programador do Visual C++.

Visão geral de COleDateTimeMembros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;COleDateTime::Format, COleDateTime::GetStatus

Index