COleDateTime::ParseDateTime

Artículo
06/09/2015

Analiza una cadena para leer un valor de fecha u hora.

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

Parámetros

lpszDate
Un puntero a la cadena terminada en null que se analice. Para obtener detalles, vea las notas.
dwFlags
Indica los marcadores para las configuraciones regionales y el análisis. Uno o más de los siguientes indicadores:
- Uso deLOCALE_NOUSEROVERRIDE las configuraciones regionales del sistema, en lugar de la configuración de usuario personalizadas.
- VAR_TIMEVALUEONLY omite a la parte de fecha durante el análisis.
- VAR_DATEVALUEONLY omite a la parte del tiempo durante el análisis.
lcid
Indica el identificador de configuración regional necesarios para la conversión.

Valor devuelto

Devuelve TRUE si la cadena se convierte correctamente a una fecha y un valor de hora, si no Falso.

Comentarios

Si la cadena se convierte correctamente a una fecha y un valor de hora, el valor de este objeto de COleDateTime se establece en ese valor y su estado a válido.

Nota
Los valores de año deben mentir entre 100 y 9999, ambos inclusive.

el parámetro de lpszDate puede tomar una variedad de formatos. Por ejemplo, las cadenas siguientes contienen la fecha aceptable y formatos de 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 el identificador de configuración regional también afectará si el formato de la cadena es aceptable para la conversión a una fecha y un valor de hora.

En el caso de VAR_DATEVALUEONLY, el valor de hora se establece para sincronizar 0, o la medianoche. En el caso de VAR_TIMEVALUEONLY, el valor de fecha se establece hasta la fecha 0, lo que significa que el 30 de diciembre de 1899.

Si la cadena no se pudo convertir a una fecha y un valor de hora o si se produjo un desbordamiento numérico, el estado de este objeto de COleDateTime no es válido.

Para obtener más información sobre los límites y la implementación por valores de COleDateTime , vea el artículo fecha y hora: Compatibilidad de automatización.