COleDateTimeSpan::Format

生成 COleDateTimeSpan 对象的已格式化的字符串表示形式。

CString Format(
   LPCTSTR pFormat 
) const;
CString Format(
   UINT nID 
) const;

参数

  • pFormat
    格式字符串与格式字符串的 printf。 格式化的代码,在一个百分号(%)后签名,则对应的 COleDateTimeSpan 元素替换。 在格式字符串中的任何其他字符按原样复制到该返回的字符串。 设置代码格式的值和含义如下 Format 的列表:

    • %H 小时在当前日期

    • %M 分钟在当前小时中

    • %S 秒在当前分钟内

    • %% 百分号

    列出的四格式代码上面是格式将接受中的唯一代码。

  • nID
    窗体控件字符串的资源ID。

返回值

包含格式化日期/时间范围值的 CString

备注

调用这些函数创建时间范围值的已格式化的表示形式。 如果此 COleDateTimeSpan 对象的状态为空,则返回值是空字符串。 如果该状态无效,则返回字符串由字符串资源 IDS_INVALID_DATETIMESPAN指定。

窗体的简短说明此功能的后面:

  • Format( pFormat )
    此窗体来设置值的格式。使用在 printf包含特殊格式代码在百分号的格式字符串(%)之后。 格式字符串将作为参数传递给函数。

  • Format( nID )
    此窗体来设置值的格式。使用在 printf包含特殊格式代码在百分号的格式字符串(%)之后。 格式字符串是资源。 该字符串资源ID将作为参数。

示例

// get the current time
COleDateTime tmStart = COleDateTime::GetCurrentTime();

// waste some time
CString str;
::Sleep(3000);

// get the current time again
COleDateTime tmFinish = COleDateTime::GetCurrentTime();

// find the difference
COleDateTimeSpan tmSpan = tmFinish - tmStart;

// tell the user
str = tmSpan.Format(_T("%S seconds elapsed"));
_tprintf_s(_T("%s\n"), (LPCTSTR) str);

要求

Header: atlcomtime.h

请参见

参考

COleDateTimeSpan选件类

层次结构图

COleDateTimeSpan::GetStatus