CFileTimeSpan 类

  • 项目

此类提供用于管理与文件关联的相对日期和时间值的方法。

语法

class CFileTimeSpan

成员

公共构造函数

名称 描述
CFileTimeSpan::CFileTimeSpan 构造函数。

公共方法

名称 描述
CFileTimeSpan::GetTimeSpan 调用此方法可从 CFileTimeSpan 对象中检索时间跨度。
CFileTimeSpan::SetTimeSpan 调用此方法可设置 CFileTimeSpan 对象的时间跨度。

公共运算符

“属性” 描述
CFileTimeSpan::operator - 对 CFileTimeSpan 对象执行减法。
CFileTimeSpan::operator != 比较两个 CFileTimeSpan 对象是否相等。
CFileTimeSpan::operator + 对 CFileTimeSpan 对象执行添加。
CFileTimeSpan::operator += 对 CFileTimeSpan 对象执行加法并对它赋予结果。
CFileTimeSpan::operator < 比较两个 CFileTimeSpan 对象以确定较小者。
CFileTimeSpan::operator <= 比较两个 CFileTimeSpan 对象以确定是否相等或较小者。
CFileTimeSpan::operator = 赋值运算符。
CFileTimeSpan::operator -= 对 CFileTimeSpan 对象执行加法并对它赋予结果。
CFileTimeSpan::operator == 比较两个 CFileTimeSpan 对象是否相等。
CFileTimeSpan::operator > 比较两个 CFileTimeSpan 对象以确定较大者。
CFileTimeSpan::operator >= 比较两个 CFileTimeSpan 对象以确定是否相等或较大者。

备注

CFileTimeSpan 类提供用于处理文件系统使用的单位中的相对时间段的方法。 这些单元通常用于文件操作，例如创建文件时、上次访问或上次修改时。 此类的方法经常与 CFileTime 类 对象一起使用。

示例

请参阅 CFileTime::Millisecond 的示例。

要求

头文件：atltime.h

CFileTimeSpan::CFileTimeSpan

构造函数。

CFileTimeSpan() throw();
CFileTimeSpan(const CFileTimeSpan& span) throw();
CFileTimeSpan(LONGLONG nSpan) throw();

参数

span
一个现有的 CFileTimeSpan 对象。

nSpan
单位 FILETIME 的时间段。

备注

CFileTimeSpan 对象可以使用现有 CFileTimeSpan 对象创建，或者以 100 纳秒 FILETIME 单位表示为 64 位值。 有关详细信息，请参阅 CFileTime。 默认构造函数将时间跨度设置为 0。

CFileTimeSpan::GetTimeSpan

调用此方法可从 CFileTimeSpan 对象中检索时间跨度。

LONGLONG GetTimeSpan() const throw();

返回值

以 100 纳秒 FILETIME 为单位返回时间跨度。 有关详细信息，请参阅 CFileTime。

CFileTimeSpan::operator -

对 CFileTimeSpan 对象执行减法。

CFileTimeSpan operator-(CFileTimeSpan span) const throw();

参数

span
CFileTimeSpan 对象。

返回值

返回 CFileTimeSpan 对象，表示两个时间跨度之间的差异的结果。

CFileTimeSpan::operator !=

比较两个 CFileTimeSpan 对象是否相等。

bool operator!=(CFileTimeSpan span) const throw();

参数

span
要比较的 CFileTimeSpan 对象。

返回值

如果所比较的项不等于 CFileTimeSpan 对象，则返回 TRUE；否则返回 FALSE。

CFileTimeSpan::operator +

对 CFileTimeSpan 对象执行添加。

CFileTimeSpan operator+(CFileTimeSpan span) const throw();

参数

span
CFileTimeSpan 对象。

返回值

返回 CFileTimeSpan 对象，该对象包含两个时间跨度的总和。

CFileTimeSpan::operator +=

对 CFileTimeSpan 对象执行加法并对它赋予结果。

CFileTimeSpan& operator+=(CFileTimeSpan span) throw();

参数

span
CFileTimeSpan 对象。

返回值

返回更新的 CFileTimeSpan 对象，该对象包含两个时间跨度的总和。

CFileTimeSpan::operator <

比较两个 CFileTimeSpan 对象以确定较小者。

bool operator<(CFileTimeSpan span) const throw();

参数

span
要比较的 CFileTimeSpan 对象。

返回值

如果第一个对象比第二个对象小（则表示更短的时间段），返回 TRUE，否则返回 FALSE。

CFileTimeSpan::operator <=

比较两个 CFileTimeSpan 对象以确定是否相等或较小者。

bool operator<=(CFileTimeSpan span) const throw();

参数

span
要比较的 CFileTimeSpan 对象。

返回值

如果第一个对象小于或等于第二个对象（则表示更短的时间段），返回 TRUE，否则返回 FALSE。

CFileTimeSpan::operator =

赋值运算符。

CFileTimeSpan& operator=(const CFileTimeSpan& span) throw();

参数

span
CFileTimeSpan 对象。

返回值

返回更新的 CFileTimeSpan 对象。

CFileTimeSpan::operator -=

对 CFileTimeSpan 对象执行减法并对它赋予结果。

CFileTimeSpan& operator-=(CFileTimeSpan span) throw();

参数

span
CFileTimeSpan 对象。

返回值

返回更新的 CFileTimeSpan 对象。

CFileTimeSpan::operator ==

比较两个 CFileTimeSpan 对象是否相等。

bool operator==(CFileTimeSpan span) const throw();

参数

span
要比较的 CFileTimeSpan 对象。

返回值

如果对象相等，则返回 TRUE；否则返回 FALSE。

CFileTimeSpan::operator >

比较两个 CFileTimeSpan 对象以确定较大者。

bool operator>(CFileTimeSpan span) const throw();

参数

span
要比较的 CFileTimeSpan 对象。

返回值

如果第一个对象比第二个对象大（则表示更长的时间段），返回 TRUE，否则返回 FALSE。

CFileTimeSpan::operator >=

比较两个 CFileTimeSpan 对象以确定是否相等或较大者。

bool operator>=(CFileTimeSpan span) const throw();

参数

span
要比较的 CFileTimeSpan 对象。

返回值

如果第一个对象大于或等于第二个对象（则表示更长的时间段），返回 TRUE，否则返回 FALSE。

CFileTimeSpan::SetTimeSpan

调用此方法可设置 CFileTimeSpan 对象的时间跨度。

void SetTimeSpan(LONGLONG nSpan) throw();

参数

nSpan
时间跨度的新值（以 100 纳秒 FILETIME 为单位）。 有关详细信息，请参阅 CFileTime。

另请参阅

FILETIME
CFileTime 类
层次结构图
ATL/MFC 共享类