COleDateTime::ParseDateTime

分析字符串读取日期/时间值。

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

参数

  • lpszDate
    对要分析的Null终止的字符串的指针。 有关详细信息,请参见备注。

  • dwFlags
    指示区域设置和分析的标志。 以下一个或多个标志:

    • LOCALE_NOUSEROVERRIDE 使用系统默认区域设置,而不是自定义用户设置。

    • 在分析过程中,VAR_TIMEVALUEONLY 忽略日期部分。

    • 在分析过程中,VAR_DATEVALUEONLY 忽略时部分。

  • lcid
    指示区域设置ID来进行转换使用。

返回值

返回 true,如果该字符串成功转换为日期/时间值,否则 false

备注

如果该字符串成功转换为日期/时间值,此 COleDateTime 对象的值设置为该值以及其状态更改为有效。

备注

年份值必须位于100和9999之间,包含。

lpszDate 参数可以采用多种格式。 例如,下面的字符串包含可接受的日期/时间格式:

"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

请注意区域设置ID也会影响字符串格式是否为日期/时间值的转换是可以接受的。

VAR_DATEVALUEONLY,时间值设置超时0或午夜。 在 VAR_TIMEVALUEONLY,该日期值迄今设置为0,这意味着1899年十二月30日。

如果该字符串不能转换为日期/时间值或者,如果有一个数字溢出,此 COleDateTime 对象的状态无效。

有关区域和实现的更多信息 COleDateTime 的值,请参见文章 日期和时间:自动化支持

要求

Header: atlcomtime.h

请参见

参考

COleDateTime选件类

层次结构图

COleDateTime::Format

COleDateTime::GetStatus