COleDateTime::Format

CString Format( DWORD dwFlags = 0, LCID lcid = LANG_USER_DEFAULT );
CString Format( LPCTSTR lpszFormat ) const;
CString Format( UINT nFormatID ) const;

返回值:包含格式化日期/时间值的CString。

参数:
dwFlags本地设置的指示标志。可能是下列值:
·LOCALE_NOUSEROVERRIDE使用系统缺省的本地设置,而不用用户自定义的本地设置。
·VAR_TIMEVALUEONLY分解时忽略日期。
·VAR_DATEVALUEONLY分解时忽略时间。

lcid指示用于转换的本地ID。
lpszFormat和printf格式化字符串相似的格式化字符串。格式化代码(用百分号%打头)将被相应的COleDateTime组成部分代替。在格式化字符串中的其它字符将复制到返回的字符串中。具体细节请参阅运行函数strftime。格式化代码的值和意义如下:
·%H当前“日”的“时”。
·%M当前“时”的“分”。
·%S当前“分”的“秒”。
·%%百分号符。

nFormatID格式控制字符串的资源ID。

说明:
调用该函数串创建一个代表日期/时间值的格式化表示。如果COleDateTime对象状态为空,则返回一个空字符串。如果状态为无效,则返回字符串为资源IDS_INVALID_DATETIME代表的字符串。
下面是该函数的三种形式的简要描述:
Format( dwFlags, lcid );
该形式将使用母语格式(本地ID)来格式化日期/时间值。使用缺省参数时,如果日期/时间值的日期部分值为0(1998年12 月30日),该形式仅打印时间;相似地,如果日期/时间值的时间部分值为0(午夜),该形式仅打印日期。如果日期/时间值的为0(1998年12 月30日午夜),该形式将打印“midnight”。
Format( lpszFormat );
该形式使用格式化字符串的特定格式化代码(以百分号%打头)来格式化。格式化字符串作为一个参数传递到函数中。有关格式化代码的信息,请参阅 “Microsoft Visual C++ 运行库参考”中的strftime, wcsftime。
Format( nFormatID );
该形式使用格式化字符串的特定格式化代码(以百分号%打头)来格式化。格式化字符串是一个资源,该字符串资源的ID作为一个参数传递到函数中。有关格式化代码的信息,请参阅 “Microsoft Visual C++运行库参考”中的strftime, wcsftime。
有关本地ID值的列表,请参阅联机文档“Win32 SDK OLE程序员参考”中的“支持多国语言”。

请参阅:
COleDateTime::ParseDateTime, COleDateTime::GetStatus