【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