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对象的比较。