C++编程中时间使用总结

各种时间类/数据结构

与时间相关的类和数据结构有: 

1. CTime

2. CTimeSpan

3. __time64_t和time_t

4. struct tm

5. SYSTEMTIME

6. FILETIME

7. DBTIMESTAMP

一. CTime

// 微软文档

http://msdn.microsoft.com/zh-cn/library/78zb0ese.aspx

1.1 定义

class CTime{public:static CTime WINAPI GetCurrentTime() throw();static BOOL WINAPI IsValidFILETIME(_In_ const FILETIME& ft) throw();CTime() throw();CTime(_In_ __time64_t time) throw();CTime(_In_ int nYear, _In_ int nMonth, _In_ int nDay, _In_ int nHour, _In_ int nMin, _In_ int nSec, _In_ int nDST = -1);CTime(_In_ WORD wDosDate, _In_ WORD wDosTime, _In_ int nDST = -1); CTime(_In_ const SYSTEMTIME& st, _In_ int nDST = -1);CTime(_In_ const FILETIME& ft, _In_ int nDST = -1);CTime(_In_ const DBTIMESTAMP& dbts, _In_ int nDST = -1) throw();CTime& operator=(_In_ __time64_t time) throw();CTime& operator+=(_In_ CTimeSpan span) throw();CTime& operator-=(_In_ CTimeSpan span) throw();CTimeSpan operator-(_In_ CTime time) const throw();CTime operator-(_In_ CTimeSpan span) const throw();CTime operator+(_In_ CTimeSpan span) const throw();bool operator==(_In_ CTime time) const throw();bool operator!=(_In_ CTime time) const throw();bool operator<(_In_ CTime time) const throw();bool operator>(_In_ CTime time) const throw();bool operator<=(_In_ CTime time) const throw();bool operator>=(_In_ CTime time) const throw();struct tm* GetGmtTm(_Out_ struct tm* ptm) const;struct tm* GetLocalTm(_Out_ struct tm* ptm) const;bool GetAsSystemTime(_Out_ SYSTEMTIME& st) const throw();bool GetAsDBTIMESTAMP(_Out_ DBTIMESTAMP& dbts) const throw();__time64_t GetTime() const throw();int GetYear() const throw();int GetMonth() const throw();int GetDay() const throw();int GetHour() const throw();int GetMinute() const throw();int GetSecond() const throw();int GetDayOfWeek() const throw();// formatting using "C" strftimeCString Format(_In_z_ LPCTSTR pszFormat) const;CString FormatGmt(_In_z_ LPCTSTR pszFormat) const;CString Format(_In_ UINT nFormatID) const;CString FormatGmt(_In_ UINT nFormatID) const;#if defined(_AFX) && defined(_UNICODE)// for compatibility with MFC 3.xCString Format(_In_z_ LPCSTR pFormat) const;CString FormatGmt(_In_z_ LPCSTR pFormat) const;#endif#ifdef _AFXCArchive& Serialize64(_In_ CArchive& ar);#endifprivate:__time64_t m_time;};

 

1.2 使用

1.2.1 构造

// 1993年3月19日22:15:00 (年月日, 时分秒)

CTime t(1999, 3, 19, 22, 15, 0);

nYear  1970–3000

nMonth 1–12

nDay 1–31

nHour 0-23

nMin 0-59

nSec 0-59

 

1.2.2 格式化成字符串

CTime t(1999, 3, 19, 22, 15, 0); 

// "Friday, March 19, 1999"

CString s = t.Format(_T("%A, %B %d, %Y"));

 

CTime::Format的参数

%a    缩写的星期名称

%A    完整星期名称

%b    缩写的月份名称

%B    完整的月份名称。

%c    日期和时间表示恰当的区域设置

%d    日期为十进制数字 (01 - 31) 的月份

%H    以 24 小时格式 (00 - 23) 的点

%I    以 12 小时格式 (01 - 12) 的点

%j    日期为十进制数字 (001 - 366)。

%m    为十进制数字 (01 - 12) 的月份

%M    为十进制数字 (00 - 59) 的分钟

%p    12 小时时钟的当前区域设置的 A.M/P.M. 指示器

%S    其次为十进制数字 (00 - 59)

%U    周为十进制数字的年份，周日为一周的第一天 (00 - 53)

%w    周为十进制数字 (0 - 6 ；0 是星期天)

%W    周为十进制数字的年份，星期一为一周的第一天 (00 - 53)

%x    当前区域设置的日期显示

%X    当前区域设置的时间显示

%y    无世纪年，为十进制数字 (00 - 99)

%Y    世纪年，为十进制数字

%z, %Z    根据注册表设置，无论是时区名称或时区缩写，如果时区未知，则没有字符

%%    百分号

 

1.2.3 获取当前时间

CTime tm = CTime::GetCurrentTime();

__time64_t CTime::GetTime( ) const throw( ); //  返回1970年一月1日到CTime对象之间的秒数

 

1.2.4 获取 年月日, 时分秒

// 10:15 PM March 19, 1999

CTime t(1999, 3, 19, 22, 15, 0);

ATLASSERT(t.GetYear() == 1999);

ATLASSERT(t.GetMonth() == 3);

ATLASSERT(t.GetDay() == 19);

ATLASSERT(t.GetHour() == 22);

ATLASSERT(t.GetMinute() == 15);

ATLASSERT(t.GetSecond() == 0);

ATLASSERT(t.GetDayOfWeek() == 1);

ATLASSERT(t.GetDayOfWeek() == 7);

 

1.2.5 CTime转tm; CTime转time_t; CTime转SYSTEMTIME;

struct tm* CTime::GetGmtTm(struct tm* ptm) const;

struct tm* CTime::GetLocalTm(struct tm* ptm) const;

__time64_t CTime::GetTime( ) const throw( ); //  返回1970年一月1日到CTime对象之间的秒数

bool GetAsSystemTime(_Out_ SYSTEMTIME& st) const throw();

bool GetAsDBTIMESTAMP(_Out_ DBTIMESTAMP& dbts) const throw();

 

1.2.6 举例

CTime time1 = CTime::GetCurrentTime(); // 获取当前时间

 

CTime time2(1999, 3, 19, 22, 15, 0); // 构造一个时间

CTime time3(1999, 3, 18, 22, 14, 30); // 构造一个时间

// time2与time3 时间相差1天0小时0分钟30秒(1 * 24 * 60 * 60 + 30)

CTimeSpan timeSpan = time2 - time3;

int nTemp = 0;

nTemp = timeSpan.GetDays(); // 1

nTemp = timeSpan.GetTotalHours(); // 24

nTemp = timeSpan.GetHours(); // 0

nTemp = timeSpan.GetTotalMinutes(); // 1440

nTemp = timeSpan.GetMinutes(); // 0

nTemp = timeSpan.GetTotalSeconds(); // 86430

nTemp = timeSpan.GetSeconds(); // 30

 

CString strTemp = time2.Format(_T("%Y-%m-%d %H:%M:%S %A")); // 输出格式: 1999-03-19 22:15:00 Friday

nTemp = time2.GetYear(); // 1999

nTemp = time2.GetMonth(); // 3

nTemp = time2.GetDay(); // 19

nTemp = time2.GetHour(); // 22

nTemp = time2.GetMinute(); // 15

nTemp = time2.GetSecond(); // 0

nTemp = time2.GetDayOfWeek(); // 6

 

 

二. CTimeSpan

用于表示时间范围

 

2.1 定义

class CTimeSpan{public:CTimeSpan() throw();CTimeSpan(_In_ __time64_t time) throw();CTimeSpan(_In_ LONG lDays,_In_ int nHours, _In_ int nMins, _In_ int nSecs) throw();LONGLONG GetDays() const throw();LONGLONG GetTotalHours() const throw();LONG GetHours() const throw();LONGLONG GetTotalMinutes() const throw();LONG GetMinutes() const throw();LONGLONG GetTotalSeconds() const throw();LONG GetSeconds() const throw();__time64_t GetTimeSpan() const throw();CTimeSpan operator+(_In_ CTimeSpan span) const throw();CTimeSpan operator-(_In_ CTimeSpan span) const throw();CTimeSpan& operator+=(_In_ CTimeSpan span) throw();CTimeSpan& operator-=(_In_ CTimeSpan span) throw();bool operator==(_In_ CTimeSpan span) const throw();bool operator!=(_In_ CTimeSpan span) const throw();bool operator<(_In_ CTimeSpan span) const throw();bool operator>(_In_ CTimeSpan span) const throw();bool operator<=(_In_ CTimeSpan span) const throw();bool operator>=(_In_ CTimeSpan span) const throw();public:CString Format(_In_z_ LPCTSTR pszFormat) const;CString Format(_In_ UINT nID) const;#if defined(_AFX) && defined(_UNICODE)// for compatibility with MFC 3.xCString Format(_In_z_ LPCSTR pFormat) const;#endif#ifdef _AFXCArchive& Serialize64(_In_ CArchive& ar);#endifprivate:__time64_t m_timeSpan;};

 

2.2 举例

CTime time1 = CTime::GetCurrentTime(); // 获取当前时间

 

CTime time2(1999, 3, 19, 22, 15, 0); // 构造一个时间

CTime time3(1999, 3, 18, 22, 14, 30); // 构造一个时间

// time2与time3 时间相差1天0小时0分钟30秒(1 * 24 * 60 * 60 + 30)

CTimeSpan timeSpan = time2 - time3;

int nTemp = 0;

nTemp = timeSpan.GetDays(); // 1

nTemp = timeSpan.GetTotalHours(); // 24

nTemp = timeSpan.GetHours(); // 0

nTemp = timeSpan.GetTotalMinutes(); // 1440

nTemp = timeSpan.GetMinutes(); // 0

nTemp = timeSpan.GetTotalSeconds(); // 86430

nTemp = timeSpan.GetSeconds(); // 30

 

CString strTemp = time2.Format(_T("%Y-%m-%d %H:%M:%S %A")); // 输出格式: 1999-03-19 22:15:00 Friday

nTemp = time2.GetYear(); // 1999

nTemp = time2.GetMonth(); // 3

nTemp = time2.GetDay(); // 19

nTemp = time2.GetHour(); // 22

nTemp = time2.GetMinute(); // 15

nTemp = time2.GetSecond(); // 0

nTemp = time2.GetDayOfWeek(); // 6

 

 

三. __time64_t和time_t

就是一个64位的整形, 可以表示秒数

typedef __time64_t time_t;      /* time value */

typedef __int64 __time64_t;     /* 64-bit time value */

 

time_t now;

time(&now); // 获取当前时间

四. struct tm

struct tm {

        int tm_sec;     /* seconds after the minute - [0,59] */

        int tm_min;     /* minutes after the hour - [0,59] */

        int tm_hour;    /* hours since midnight - [0,23] */

        int tm_mday;    /* day of the month - [1,31] */

        int tm_mon;     /* months since January - [0,11] */

        int tm_year;    /* years since 1900 */

        int tm_wday;    /* days since Sunday - [0,6] */

        int tm_yday;    /* days since January 1 - [0,365] */

        int tm_isdst;   /* daylight savings time flag 夏令时标识符，实行夏令时的时候，tm_isdst为正。 */

                        /* 不实行夏令时的进候，tm_isdst为0；不了解情况时，tm_isdst()为负*/

};

4.1 CTime与tm

CTime有函数可以填充tm;

struct tm* CTime::GetGmtTm(struct tm* ptm) const; // 获取CTime对象的时间

struct tm* CTime::GetLocalTm(struct tm* ptm) const; // 获取当前时间

 

4.2 CTime转tm

CTime time2(1999, 3, 19, 22, 15, 0); // 构造一个时间

tm osTime1, osTime2;

time2.GetLocalTm(&osTime1);

time2.GetGmtTm(&osTime2);

ATLTRACE(_T("Difference between local time and GMT is %d hours.\n"), osTime1.tm_hour - osTime2.tm_hour);

 

 

4.3 time_t与tm互转

4.3.1 time_t转tm

time_t tt = time2.GetTime();

struct tm tm1;

localtime_s(&tm1, &tt);

struct tm temptm = *localtime(&t1); // 这个函数也可以, 但是返回的是一个指针, 尽量不使用

4.3.2 tm转time_t

struct tm tm1;

......

time_t tt2 = mktime(&tm1);

五. SYSTEMTIME

5.1 定义

typedef struct _SYSTEMTIME {

    WORD wYear; // The current year.

    WORD wMonth; // The current month; January is 1.

    WORD wDayOfWeek; // The current day of the week; Sunday is 0, Monday is 1, and so on.

    WORD wDay; // The current day of the month.

    WORD wHour; // The current hour.

    WORD wMinute; // The current minute.

    WORD wSecond; // The current second.

    WORD wMilliseconds; // The current millisecond.

};

SYSTEMTIME是属于Window上的结构

5.2 例子

SYSTEMTIME systime;GetSystemTime(&systime);

 

5.3 tm与SYSTEMTIME 互转

5.3.1 tm转SYSTEMTIME

struct tm tm1;

......

SYSTEMTIME st = {1900 + tm1.tm_year, 1 + tm1.tm_mon, tm1.tm_wday, tm1.tm_mday, tm1.tm_hour, tm1.tm_min, tm1.tm_sec, 0};

 

5.3.2 SYSTEMTIME转tm

// 四年一闰, 百年不闰, 四百年再闰.bool IsLeapYear(int nYear){// 闰年: 能被400整除的是闰年; 能被4整除并且不被100整除的也是闰年;return (0 == (nYear % 400)) || ((0 == (nYear % 4)) && (0 != (nYear % 100)));}int GetYearDay(int nYear, int nMonth, int nMDay){int nMonthDaysLeap[12]= {31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31};int nMonthDaysNonLeap[12]= {31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31};int* pDays = 0;// 简单校验if(1 > nMonth || 12 < nMonth || 1 > nMDay){return 0;}// 是否闰年pDays = IsLeapYear(nYear) ? nMonthDaysLeap : nMonthDaysNonLeap;if(nMDay > pDays[nMonth - 1]){return 0;}int nYearDay = nMDay;--nMonth;int i = 0;for(i = 0; i < nMonth; ++i){nYearDay += pDays[i];}return nYearDay;}SYSTEMTIME st;......int nYearDay = GetYearDay(st.wYear, st.wMonth, st.wDay);struct tm tm2 = {st.wSecond, st.wMinute, st.wHour, st.wDay, st.wMonth-1, st.wYear-1900, st.wDayOfWeek, nYearDay - 1, 0};

 

 

六. FILETIME

typedef struct _FILETIME {

    DWORD dwLowDateTime;

    DWORD dwHighDateTime;

} FILETIME

6.1 相关函数

BOOL SystemTimeToFileTime(CONST SYSTEMTIME *lpSystemTime, LPFILETIME lpFileTime);

BOOL FileTimeToSystemTime(CONST FILETIME *lpFileTime, LPSYSTEMTIME lpSystemTime);

 

6.2 FILETIME和SYSTEMTIME互转

BOOL SystemTimeToFileTime(CONST SYSTEMTIME *lpSystemTime, LPFILETIME lpFileTime);

BOOL FileTimeToSystemTime(CONST FILETIME *lpFileTime, LPSYSTEMTIME lpSystemTime); 

 

七. 时间的格式化

8.1 CTime::Format

CTime t(1999, 3, 19, 22, 15, 0); 

// "Friday, March 19, 1999"

CString s = t.Format(_T("%A, %B %d, %Y"));

 

8.2 strftime

size_t strftime(char *strDest, size_t maxsize, const char *format, const struct tm *timeptr);

 

%a 星期几的简写 

%A 星期几的全称 

%b 月分的简写 

%B 月份的全称 

%c 标准的日期的时间串 

%C 年份的后两位数字 

%d 十进制表示的每月的第几天 

%D 月/天/年 

%e 在两字符域中，十进制表示的每月的第几天 

%F 年-月-日 

%g 年份的后两位数字，使用基于周的年 

%G 年分，使用基于周的年 

%h 简写的月份名 

%H 24小时制的小时 

%I 12小时制的小时

%j 十进制表示的每年的第几天 

%m 十进制表示的月份 

%M 十时制表示的分钟数 

%n 新行符 

%p 本地的AM或PM的等价显示 

%r 12小时的时间 

%R 显示小时和分钟：hh:mm 

%S 十进制的秒数 

%t 水平制表符 

%T 显示时分秒：hh:mm:ss 

%u 每周的第几天，星期一为第一天 （值从0到6，星期一为0）

%U 第年的第几周，把星期日做为第一天（值从0到53）

%V 每年的第几周，使用基于周的年 

%w 十进制表示的星期几（值从0到6，星期天为0）

%W 每年的第几周，把星期一做为第一天（值从0到53） 

%x 标准的日期串 

%X 标准的时间串 

%y 不带世纪的十进制年份（值从0到99）

%Y 带世纪部分的十制年份 

%z，%Z 时区名称，如果不能得到时区名称则返回空字符。

%% 百分号

 

八. 小结

1. 在上面的结果中, SYSTEMTIME结构可以提高毫秒信息.

2. CTime, struct tm, time_t, SYSTEMTIME之间都可以直接或者间接的互转.