MFC:CTime类和CTimeSpan类

时间:2022-02-23 05:01:04


CTime类

CTime类表示日期和时间,上限是3000年12月31日,下限是1970年1月1日 12:00:00 AM GMT。

CTime(); 构造一个未经初始化的CTime对象。此状态的CTime对象,值为0,表示1970年1月1日 12:00:00 AM GMT,转换为北京时间后为1970年1月1日 8:00:00。

CTime(__time64_t time); 以一个__time64_t(注意:最前面的下划线有两条)类型的数据来构造一个CTime对象。
  time以秒为单位,参数time是一个__time64_t类型的值,表示自GMT时间1970年1月1日零点以来的秒数,这里要注意的是,参数time代表的时间会转换为本地时间保存到构造的CTime对象中。

CTime(int nYear, int nMonth, int nDay, int nHour, int nMin, int nSec, int nDST = -1);
  以本地时间的年、月、日、小时、分钟、秒等几个时间分量构造CTime对象。参数nYear、nMonth、nDay、nHour、nMin、nSec分别表示年、月、日、小时、分钟、秒,取值范围如下:
    nYear 1970-3000
    nMonth 1-12
    nDay 1-31
    nHour 0-23
    nMin 0-59
    nSec 0-59
    nDST 指定是否实行夏令时,为0时表示实行标准时间,为正数时表示实行夏令时,为负数时由系统自动计算实行的是标准时间还是夏令时。

CTime(const SYSTEMTIME& st, int nDST = - 1); 以一个SYSTEMTIME结构体变量来构造CTime对象

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时间分量代替,而其他字符会原封不动的拷贝到返回字符串中。格式码及含义如下:
    %Y:年(1970 - 3000)
    %m:月的十进制表示(01-12)
    %d:日(01 - 31)
    %H:时,24小时制 (00-23)
    %I:时,12小时制 (00-11)
    %M:分钟(00-59)
    %S:秒(00-59)
    %p:12小时制的上下午标示(AM/PM)
    %w:十进制表示的星期几(0-6)
    %a:周的英文缩写形式
    %A:周的英文全名形式
    %c:完整的日期和时间
    %b:月的英文缩写形式,如Jan
    %B:月的英文全名形式,如January
    %j:十进制表示的一年中的第几天(001-366)
    %U:一年中的第几个星期(00-51),星期日是一周的第一天
    %W:一年中的第几个星期(00-51),星期一是一周的第一天

  举个例子,以"年-月-日 时:分:秒"格式来显示当时间的格式如下:
    CTime time = CTime::GetCurrentTime();
    time.Format(_T("%Y-%m-%d %H:%M:%S"));
    其中将以4位数显示年,其它数字以2位显示,不足时前面补0。

CTime类还可以直接用于计算:
  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对象赋予一个新的时间值。

用于比较的运算符:
  operator == 比较两个绝对时间是否相等。
  operator != 比较两个绝对时间是否不相等。
  operator > 比较两个绝对时间,是否前一个大于后一个。
  operator < 比较两个绝对时间,是否前一个小于后一个。
  operator >= 比较两个绝对时间,是否前一个大于等于后一个。
  operator <= 比较两个绝对时间,是否前一个小于等于后一个。

CTimeSpan类

CTimeSpan表示的是时间间隔。

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

CTimeSpan(__time64_t time); 以一个__time64_t类型的数据来构造CTimeSpan对象,time以秒为单位。

CTimeSpan(LONG lDays, int nHours, int nMins, int nSecs); 以天、小时、分钟、秒等时间分量来构造CTimeSpan对象。每个时间分量的取值范围如下:

lDays 0-25000
nHours 0-23
nMins 0-59
nSecs 0-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对象的比较。