CT imeSpan

CTimeSpan 没有基类。

个 CTimeSpan 对象代表一个相对的时间段。 CTimeSpan 引入

了 ANSI tim e_t 数据及与之相关的运行时函数。这些函数将秒转换为日，时，分和秒的各种组合。
个 CTimeSpan 对象以秒为单位保存时间。由于 CTimeSpan 对

象以带符号的四字节数存储，所以最大的时间跨度近似为 +-68 年。

另外一个与 CTimeSpan 对应的类是 CTim e，它描述的是绝对时间。 CTimeSpan

是两个 CTime 对象之间的差。

CTime 和 CTimeSpan 类不可派生。因为没有虚函数，所以 CTime 和 CTimeSpan

对象的大小都正好是四字节。大多数成员函数都是内联函数。

有关使用 CTime 的更多信息，参见 “ Visual C++ 程序员指南 ” 中的文章 “ 日期和时间”，以及“ Microsoft Visual C++ 6.0 参考库”的“ Microsoft Visual C++ 6.0 运行时库参考 ” 卷中的 “ 时间管理 ” 。

#include <afx.h>

请参阅 Run-time functions: asctime, _ftime, gmtime, localtime, strftime, time

CTimeSpan 类成员

Construction

CTimeSpan 用不同的方法构造 CtimeSpan 对象

Extraction

GetDays 返回此 CTimeSpan 对象中的完整的天数

GetHours 返回当前日中的小时数（ -23 至 +23 ） GetTotalHours 返回此 CTimeSpan. 对象中的完整的小时数GetMinutes 返回当前小时中的分钟数（ -59 至 +59 ） GetTotalMinutes 返回此 CTimeSpan. 对象中的完整的分钟数GetSeconds 返回当前分钟中的秒数（ -59 至 +59 ） GetTotalSeconds 返回此 CTimeSpan. 对象中的完整的秒数

Conversion

Format 将一个 CTimeSpan 转换为一个格式化的字符串

Operators

Operator = 赋一个新的时间段值

Operator +- 加或减去 CTimeSpan 对象

Operator += -= 向或从此 CTimeSpan 中加上或减去一个 CTimeSpan

对象

Operator == < etc. 比较两个相对的时间值

Archive/Dump

operator<< 向 CArchive 或 CDumpContext 输出一个一个

CTimeSpan 对象

operator>> 从 CArchive 输入一个 CTimeSpan 对象

成员函数

CTimeSpan::CTimeSpan

CTimeSpan( );

CTimeSpan( const CTimeSpan& timeSpanSrc ); CTimeSpan( time_t time );

CTimeSpan( LONG lDays , int nHours , int nMins , int nSecs );

参数

timeSpanSrc

一个已存在的 CTimeSpan 对象。

time

一个 time_t 时间值。

lDays, nHours, nMins, nSecs

分别代表日，时，分，秒

说明

所有这些构造函数都创建一个新的 CTimeSpan 对象，并用指定的相对时间值来对其进行初始化。下面是对每一个构造函数的描述：

CTimeSpan( ); 构造一个没有被初始化的 CTimeSpan 对象。
CTimeSpan( const CTimeSpan& ); 从另一个 CTimeSpan 值构造一个

CTimeSpan 对象。

CTimeSpan( time_t ); 从一个 time_t 类型构造一个 CTimeSpan
对象。这个

time_t 值应该是两个绝对 time_t 值的差。

CTimeSpan( LONG, int, int, int ); 由时间跨度的组成部分构
造一个

CTimeSpan 对象。每一个成分都受下列范围的限制：

C omponent Range

LDays	至	25,000 （近似值）
NHours	至	23
N M ins	至	59
NSecs	至	59

注意，如果有一个或多个时间 – 日成分超出了范围，则 Microsoft 基础类库将给出断言。在调用之前由你负责检验参数是否有效。

示例

// CTimeSpan::CTimeSpan 示例CTimeSpan ts1; // 没有初始化的时间值CTimeSpan ts2a( ts1 ); // Copy constructor

CTimeSpan ts2b = ts1; // Copy constructor again CTimeSpan ts3( 100 ); // 100 seconds

CTimeSpan ts4( 0, 1, 5, 12 ); // 1 hour, 5 minutes, and 12 seconds

CTimeSpan::Format

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

返回值

返回一个包含格式化的时间的 CString 对象。

参数

pFormat

一个类似于 printf 格式化字符串的格式化字符串。前面有一个百分号（ % ）标记的格式化代码，将被相应的 CTimeSpan 成分替换。格式化字符串中的其它字符被不作变动地拷贝到返回字符串中。 Format 的格式化代码的值和意义如下所示：

％ D 此 CTime 中的总天数。
% H 当前天的小时。
% M 当前小时中的分钟。
%S 当前分钟中的秒。
% % 百分号。

nID

用来表示这个格式的字符串的 ID 。

说明

生成一个对应于此 CTimeSpan 的格式化字符串。

库的调试版检查格式化代码，如果代码不在上面的列表中，则将给出断言。

示例

// CTimeSpan::Format 示例

CTimeSpan ts( 3, 1, 5, 12 ); // 3 days, 1 hour, 5 min, and 12 sec

CString s = ts.Format( "Total days: %D, hours: %H, mins: %M, secs: %S" ); ASSERT( s == "Total days: 3, hours: 01, mins: 05, secs: 12" );

CTimeSpan::GetDays LONG GetDays( ) const; 说明

此成员函数返回完整的天数。如果该时间段是负的，则这个值可能是负的。

示例

// CTimeSpan::GetDays 示例

CTimeSpan ts( 3, 1, 5, 12 ); // 3 days, 1 hour, 5 min, and 12 sec ASSERT( ts.GetDays() == 3 );

CTimeSpan::GetHours

int GetHours( ) const;

说明

此成员函数返回当前日的小时数。其范围是 -23 到 +23 。

示例

// CTimeSpan::GetHours 示例

CTimeSpan ts( 3, 1, 5, 12 ); // 3 days, 1 hour, 5 min, and 12 sec ASSERT( ts.GetHours() == 1 );

ASSERT( ts.GetMinutes() == 5 );

ASSERT( ts.GetSeconds() == 12 );

CTimeSpan::GetMinutes

int GetMinutes( ) const;

说明

此成员函数返回当前小时中的分钟数。范围是 -59 到 59 。

示例

参见 GetHours 的示例。

CTimeSpan::GetSeconds

int GetSeconds( ) const;

说明

此成员函数返回当前分钟中的秒数。范围是 -59 到 59 。

示例

参见 GetHours 的示例

CTimeSpan::GetTotalHours LONG GetTotalHours( ) const; 说明

此成员函数返回此 CTimeSpan 中的完整小时数。

示例

// CTimeSpan::GetTotalHours 示例

CTimeSpan ts( 3, 1, 5, 12 ); // 3 days, 1 hour, 5 min, and 12 sec ASSERT( ts.GetTotalHours() == 73 );

ASSERT( ts.GetTotalMinutes() == 4385 ); ASSERT( ts.GetTotalSeconds() == 263112 );

CTimeSpan::GetTotalMinutes LONG GetTotalMinutes( ) const; 说明

此成员函数返回此 CTimeSpan 中的完整分钟数。

示例

参见 GetTotalHours 的示例。

CTimeSpan::GetTotalSecond LONG GetTotalSeconds( ) const; 说明

此成员函数返回此 CTimeSpan 中的完整秒数。

参见 GetTotalHours 的示例。

操作符

CTimeSpan::operator =

const CTimeSpan& operator =( const CTimeSpan& timeSpanSrc );

说明

这些重载的赋值操作符将源 CTimeSpan timeSpanSrc 对象拷贝到此 CTimeSpan

对象中。

// CTimeSpan::operator = 示例

CTimeSpan ts1;

CTimeSpan ts2( 3, 1, 5, 12 ); // 3 days, 1 hour, 5 min, and 12 sec ts1 = ts2;

ASSERT( ts1 == ts2 );

请参阅 CTimeSpan::CTimeSpan

CTimeSpan::operator + -

CTimeSpan operator +( CTimeSpan timeSpan ) const; CTimeSpan operator - LCTimeSpan timeSpan ) const;

说明

这两个操作符允许你将两个 CTimeSpan 对象相加或相减。

// CTimeSpan::operator +, - 示例

CTimeSpan ts1( 3, 1, 5, 12 ); // 3 days, 1 hour, 5 min, and 12 sec CTimeSpan ts2( 100 ); // 100 seconds

CTimeSpan ts3 = ts1 + ts2;

CTimeSpan::operator += -=

const CTimeSpan& operator +=( CTimeSpan timeSpan ); const CTimeSpan& operator -=( CTimeSpan timeSpan );

说明

这些操作符允许你向或从此 CTimeSpan 中加上或减去一个 CTimeSpan 对象。

示例

// CTimeSpan::operator +=, -= 示例

CTimeSpan ts1( 10 ); // 10 seconds

CTimeSpan ts2( 100 ); // 100 seconds ts2 -= ts1;

ASSERT( ts2.GetTotalSeconds() == 90 );

CTimeSpan Comparison Operators

BOOL operator ==( CTimeSpan timeSpan ) const; BOOL operator !=( CTimeSpan timeSpan ) const; BOOL operator <( CTimeSpan timeSpan ) const; BOOL operator >( CTimeSpan timeSpan ) const; BOOL operator <=( CTimeSpan timeSpan ) const; BOOL operator >=( CTimeSpan timeSpan ) const;

说明

这些操作符比较两个相对时间值。如果测试条件为真，则返回非零值；否则返回 0 。

示例

// CTimeSpan 比较操作符示例CTimeSpan ts1( 100 ); CTimeSpan ts2( 110 );

ASSERT( ( ts1 != ts2 ) && ( ts1 < ts2 ) && ( ts1 <= ts2 ) );

CTimeSpan::operator <<, >>

friend CDumpContext& AFXAPI operator<<( CDumpContext& dc , CTimeSpan

timeSpan );

friend CArchive& AFXAPI operator<<( CArchive& ar , CTimeSpan timeSpan ); friend CArchive& AFXAPI operator>>( CArchive& ar , CTimeSpan& rtimeSpan );

说明

CTimeSpan 插入操作符（ << ）支持向一个存档进行诊断转储和存储。提取操作符（ >> ）支持从一个存档中装入。

当你向一个转储环境发送 CTimeSpan 对象时，时间跨度以日，时，分和秒的数

字字符格式显示出来。

示例

// CTimeSpan::operators <<, >> 示例

CTimeSpan ts( 3, 1, 5, 12 ); // 3 days, 1 hour, 5 min, and 12 sec #ifdef _DEBUG

afxDump << ts << "\n"; #endif

// Prints 'CTimeSpan(3 days, 1 hours, 5 minutes and 12 seconds)'

extern CArchive ar; if( ar.IsLoading( ))

ar >> ts; else

ar << ts;

CT imeSpan

CT imeSpan

CTimeSpan 类 成 员

成 员 函 数

操 作 符

CTimeSpan 类成员

成员函数

操作符