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。