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

请参见

参考

COleDateTime选件类

层次结构图

COleDateTime::ParseDateTime

COleDateTime::GetStatus