【VS开发】CTimeSpan类

CTimeSpan类。

       日期和时间类简介

       CTime类的对象表示的时间是基于格林威治标准时间（GMT）的。CTimeSpan类的对象表示的是时间间隔。

       CTime类和CTimeSpan类一般不会被继承使用。两者对象的大小都是8个字节。

       CTime表示的日期上限是3000年12月31日，下限是1970年1月1日 12:00:00 AM GMT。

       CTime类的主要成员函数

       下面列出CTime类的主要成员函数，并加以讲解。

       CTime();

       构造一个未经初始化的CTime对象。此构造函数使我们可以定义一个CTime对象的数组，在使用数组前需要以有效的时间值为其初始化。

       CTime(__time64_t time);

       以一个__time64_t（注意：最前面的下划线有两条）类型的数据来构造一个CTime对象。参数time是一个__time64_t类型的值，表示自GMT时间1970年1月1日零点以来的秒数，这里要注意的是，参数time代表的时间会转换为本地时间保存到构造的CTime对象中。例如，我们传递参数0构造一个CTime对象，然后调用CTime对象的GetHour成员函数将返回8，因为参数0代表的GMT时间转换为北京时间后为1970年1月1日 8:00:00。

CTime(

   int nYear,

   int nMonth,

   int nDay,

   int nHour,

   int nMin,

   int nSec,

   int nDST = -1 

);

       以本地时间的年、月、日、小时、分钟、秒等几个时间分量构造CTime对象。参数nYear、nMonth、nDay、nHour、nMin、nSec分别表示年、月、日、小时、分钟、秒，取值范围如下：

时间分量取值范围

nYear1970-3000

nMonth1-12

nDay1-31

nHour0-23

nMin0-59

nSec0-59

参数nDST指定是否实行夏令时，为0时表示实行标准时间，为正数时表示实行夏令时，为负数时由系统自动计算实行的是标准时间还是夏令时。

       CTime(const SYSTEMTIME& st,int nDST = - 1) ;

       以一个SYSTEMTIME结构体变量来构造CTime对象。SYSTEMTIME结构体也是我们对日期时间的常用表示方式。参数st为以本地时间表示的SYSTEMTIME对象，参数nDST同上。

       static CTime WINAPI GetCurrentTime( );

       获取系统当前日期和时间。返回表示当前日期和时间的CTime对象。

       int GetYear( ) const；

       获取CTime对象表示时间的年份。范围从1970年1月1日到2038年（包括2038年）1月18日。

       int GetMonth( ) const;

       获取CTime对象表示时间的月份。范围为1到12。

       int GetDay( ) const;

       获取CTime对象表示时间的日期。范围为1到31。

       int GetHour( ) const;

       获取CTime对象表示时间的小时。范围为0到23。

       int GetMinute( ) const;

       获取CTime对象表示时间的分钟。范围为0到59。     

       int GetSecond( ) const;

       获取CTime对象表示时间的秒。范围为0到59。

       int GetDayOfWeek( ) const;

       此函数的返回值表示CTime对象代表的是星期几，1表示是周日，2表示是周一，以此类推。

       CString Format(LPCTSTR pszFormat) const;

       将CTime对象中的时间信息格式化为字符串。参数pszFormat是格式化字符串，与printf中的格式化字符串类似，格式化字符串中带有%前缀的格式码将会被相应的CTime时间分量代替，而其他字符会原封不动的拷贝到返回字符串中。格式码及含义如下：

%a：周的英文缩写形式。

%A：周的英文全名形式。

%b： 月的英文缩写形式。

%B：月的英文全名形式。

%c： 完整的日期和时间。

%d：十进制形式的日期（01-31）。

%H：24小时制的小时（00-23）。

%I： 12小时制的小时（00-11）。

%j： 十进制表示的一年中的第几天（001-366）。

%m： 月的十进制表示（01-12）。

%M：十进制表示的分钟（00-59）。

%p： 12小时制的上下午标示（AM/PM）。

%S： 十进制表示的秒（00-59）。

%U： 一年中的第几个星期（00-51），星期日是一周的第一天。

%W： 一年中的第几个星期（00-51），星期一是一周的第一天。

%w： 十进制表示的星期几（0-6）。

%Y： 十进制表示的年。

       CTime operator +(CTimeSpan timeSpan) const;

       将CTime对象和CTimeSpan对象相加，返回一个CTime对象。实际意义就是在一个时间的基础上推后一个时间间隔，得到一个新的时间。

       CTime operator -(CTimeSpan timeSpan) const;

       将CTime对象和一个CTimeSpan相减，返回一个CTime对象。实际意义就是在一个时间的基础上提前一个时间间隔，得到一个新的时间。

       CTimeSpan operator -(CTime time) const;

       将该CTime对象和另一个CTime对象相减，返回一个CTimeSpan对象。实际意义就是计算两个时间点的间隔，得到一个CTimeSpan对象。

       CTime& operator +=(CTimeSpan span);

       为该CTime对象增加一个span表示的时间间隔。

       CTime& operator -=(CTimeSpan span);

       为该CTime对象减去一个span表示的时间间隔。

       CTime& operator =(__time64_t time);

       为该CTime对象赋予一个新的时间值。

       简单说下剩下的几个重载i运算符：

       operator == ：    比较两个绝对时间是否相等。

       operator != ：    比较两个绝对时间是否不相等。

       operator > ：    比较两个绝对时间，是否前一个大于后一个。

       operator < ：    比较两个绝对时间，是否前一个小于后一个。

       operator >=    ： 比较两个绝对时间，是否前一个大于等于后一个。

       operator <=    ： 比较两个绝对时间，是否前一个小于等于后一个。

       CTimeSpan类的主要成员函数

       前面介绍了CTime类的成员函数，再来看CTimeSpan类的成员函数就比较容易了，这里只做简单介绍。

       CTimeSpan( );

       构造一个未经初始化的CTimeSpan对象。

       CTimeSpan(__time64_t time);

       以一个__time64_t类型的数据来构造CTimeSpan对象，参数time的含义上面CTime(__time64_t time)的讲解。

CTimeSpan(

   LONG lDays,

   int nHours,

   int nMins,

   int nSecs 

);

       以天、小时、分钟、秒等时间分量来构造CTimeSpan对象。每个时间分量的取值范围如下：

时间分量取值范围

lDays0-25000（大约）

nHours0-23

nMins0-59

nSecs0-59

GetDays()：获得CTimeSpan类对象中包含的完整的天数。

       GetHours()：获得当天的小时数，取值范围为-23到23。

       GetTotalHours()：获得CTimeSpan类对象中包含的完整的小时数。

       GetMinutes()：获得当前小时包含的分数，取值范围为-59到59。

       GetTotalMinutes()：获得CTimeSpan类对象中包含的完整的分数。

       GetSeconds()：获得当前分钟包含的秒数，取值范围为-59到59。

       GetTotalSeconds()：获得CTimeSpan类对象中包含的完整的秒数。

       CString Format(LPCTSTR pszFormat) const;

       将一个CTimeSpan对象格式化为字符串。使用方式与CTime::Format类似，格式码及含义如下：

       %D：CTimeSpan对象中的总天数；

       %H：不足整天的小时数；

       %M：不足1小时的分钟数；

       %S：不足1分钟的秒数；

       %%：百分号。

       另外，CTimeSpan类也重载了运算符“=”，“+”，“-”，“+=”，“-=”，“==”，“!=”，“<”，“>”，“<=”，“>=”，用于CTimeSpan对象的赋值、加减运算及两个CTimeSpan对象的比较。

       CTime类和CTimeSpan类的应用实例

       鸡啄米在下面将为大家演示如何得到当前时间、计算两个时间的时间差以及CTime对象怎样格式化为字符串等。具体步骤如下：

       1. 创建一个Win32 Console Application工程，Name设为“Example43”。

       2. 因为要使用到CTime类、CTimeSpan类和cout输出流，所以在Example43.cpp文件中包含相应的头文件：

C++代码

#include "atltime.h"    

#include <iostream>    

using namespace std;

3. 修改main函数如下：

C++代码

int _tmain(int argc, _TCHAR* argv[])    

{    

    CString strTime;  // 用于将CTime对象格式化为字符串    

    // 获取当前时间并保存到curTime    

    CTime curTime = CTime::GetCurrentTime();    

   

    int nYear = curTime.GetYear();  // 获取当前年份    

    int nMonth = curTime.GetMonth(); // 获取当前月份    

    int nDay = curTime.GetDay();   // 获取当前日期    

    int nHour = curTime.GetHour();  // 获取当前小时时间    

    int nMin = curTime.GetMinute(); // 获取当前分钟时间    

    int nSec = curTime.GetSecond(); // 获取当前秒时间    

   

    // 输出当前时间    

    cout<<"当前时间："<<endl;    

    cout<<nYear<<"年"<<nMonth<<"月"<<nDay<<"日"<<nHour<<"时"<<nMin<<"分"<<nSec<<"秒"<<endl;    

   

    // 为计算时间差，设定一个起始时间并输出    

    CTime startTime = CTime(2010,7,3,10,20,30);    

    cout<<"起始时间："<<endl;    

    cout<<startTime.GetYear()<<"年"<<startTime.GetMonth()<<"月"<<startTime.GetDay()<<"日"<<startTime.GetHour()<<"时"<<startTime.GetMinute()<<"分"<<startTime.GetSecond()<<"秒"<<endl;    

   

    // 计算时间差    

    CTimeSpan timeSpan;    

    timeSpan = curTime - startTime;    

    cout<<"两时间相差："<<endl;    

    cout<<timeSpan.GetDays()<<"天"<<timeSpan.GetHours()<<"小时"<<timeSpan.GetMinutes()<<"分"<<timeSpan.GetSeconds()<<"秒"<<endl;    

    cout<<"总小时数："<<timeSpan.GetTotalHours()<<"小时"<<endl;    

    cout<<"总分钟数："<<timeSpan.GetTotalMinutes()<<"分"<<endl;    

    cout<<"总秒数："<<timeSpan.GetTotalSeconds()<<"秒"<<endl;       

   

    // 将当前时间curTime对象格式化为字符串    

    strTime = curTime.Format(_T("%Y-%m-%d %H:%M:%S"));    

    // 输出格式化字符串，由于字符串使用Unicode字符，所以要使用wcout输出    

    wcout<<(LPCTSTR)strTime<<endl;    

   

    return 0;    

}

其中的注释已经解释的比较清楚，相信大家都能够理解。

       4. 运行程序，效果如下：

好了，有关CTime类和CTimeSpan类的相关内容就讲到这里了，如果大家觉得还有必要了解更加详细的知识可以参阅MSDN文档。最后鸡啄米谢谢大家一直以来的支持。

本文来源于鸡啄米 http://www.jizhuomi.com/ , 原文地址：http://www.jizhuomi.com/software/230.html