COleDateTime::Format
创建日期/时间值的已格式化的表示形式。
CString Format(
DWORD dwFlags = 0,
LCID lcid = LANG_USER_DEFAULT
) const;
CString Format(
LPCTSTR lpszFormat
) const;
CString Format(
UINT nFormatID
) const;
参数
dwFlags
指示以下区域设置标志之一:LOCALE_NOUSEROVERRIDE 使用系统默认区域设置,而不是自定义用户设置。
在分析过程中,VAR_TIMEVALUEONLY 忽略日期部分。
在分析过程中,VAR_DATEVALUEONLY 忽略时部分。
lcid
指示区域设置 ID 来进行转换使用。 有关语言标识符的更多信息,请参见 语言标识符。lpszFormat
格式字符串与格式字符串的 printf。 每个格式代码,在一个百分号 (%) 后签名,则对应的 COleDateTime 元素替换。 在格式字符串中的任何其他字符按原样复制到该返回的字符串。 请参见该运行时函数 strftime 有关更多信息。 设置代码格式的值和 Format 的含义为:%H 小时在当前日期
%M 分钟在当前小时中
%S 秒在当前分钟内
%% 百分号
nFormatID
窗体控件字符串的资源 ID。
返回值
包含格式化日期/时间值的 CString。
备注
如果此 COleDateTime 对象的状态为空,则返回值是空字符串。 如果该状态无效,则返回字符串由字符串资源 ATL_IDS_DATETIME_INVALID指定。
三个窗体的简短说明此功能的后面:
Format( dwFlags, lcid)
此窗体来设置值的格式。通过使用语言规范 (区域设置 ID) 日期和时间。 使用默认参数,此窗体将打印该日期和时间,因此,除非时部分是 0 (午夜),那么,在将打印该日期情况下,或日期部分是 0 (1899 年十二月 30 日),那么,在将打印时情况下。 如果日期/时间值为 0 (1899 年十二月 30 日,午夜),而默认参数的此窗体将打印午夜。Format( lpszFormat)
此窗体来设置值的格式。通过在 printf包含特殊格式代码在百分号的格式字符串 (%) 之后。 格式字符串将作为参数传递给函数。 有关设置代码格式的更多信息,请在"运行库参考 strftime,wcsftime 引用。Format( nFormatID)
此窗体来设置值的格式。通过在 printf包含特殊格式代码在百分号的格式字符串 (%) 之后。 格式字符串是资源。 该字符串资源 ID 将作为参数。 有关设置代码格式的更多信息,请参见。运行库参考的 strftime,wcsftime。
示例
COleDateTime t(1999, 3, 19, 22, 15, 0);
CString str = t.Format(_T("%A, %B %d, %Y"));
ASSERT(str == _T("Friday, March 19, 1999"));
要求
标头: atlcomtime.h