COleDateTime::ParseDateTime

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

返回值:
如果字符串成功转换为日期/时间值,则返回非零值;否则为0。

参数:
lpszDate指向要分解的字符串的指针。详情请参阅说明。
dwFlags本地设置的指示标志。可能是下列值:
·LOCALE_NOUSEROVERRIDE使用系统缺省的本地设置,而不用用户自定义的本地设置。
·VAR_TIMEVALUEONLY分解时忽略日期。
·VAR_DATEVALUEONLY分解时忽略时间。
lcid指示用于转换的本地ID。

说明:
调用该函数串解析一个字符串,读取成一个日期/时间值。如果字符串成功转换为一个日期/时间值,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年12月30日。
如果字符串不能转换成一个日期/时间值,或出现了运算溢出,该COleDateTime对象的状态设置为无效。
如果因为内存分配出错而使字符串转换失败,该函数引发CMemoryException。出现错误时,该函数引发COleException。
有关locale ID值的列表,请参阅联机文档“Win32 SDK OLE程序员参考”中的“支持多国语言”。
有关COleDateTime值的边界和实现,请参阅联机文档《Visual C++程序员指南》中的“日期和时间:自动支持”。

请参阅:
COleDateTime::Format, COleDateTime::GetStatus