C/C++中的时间操作

1. 词汇解释

Coordinated Universal Time(UCT)
协调世界时，又称为世界标准时间，亦即格林威治标准时间（Greenwich Mean Time，GMT）。中国内地是UTC+8，美国是UTC-5。

Calendar Time
日历时间，是用“从一个标准时间点到此时的时间经过的秒数”来表示的时间。这个标准时间点对不同的编译器来说会有所不同，但对一个编译系统来说，这个标准时间点是不变的，该编译系统中的时间对应的日历时间都通过该标准时间点来衡量，所以可以说日历时间是“相对时间”，但是无论你在哪一个时区，在同一时刻对同一个标准时间点来说，日历时间都是一样的。

epoch
时间点，时间点在标准C/C++中是一个整数，它用此时的时间和标准时间点相差的秒数（即日历时间）来表示。

clock tick

时钟计时单元（而不把它叫做时钟滴答次数），一个时钟计时单元的时间长短是由CPU控制的。一个clock tick不是CPU的一个时钟周期，而是C/C++的一个基本计时单位。

2. 相关数据类型和函数

头文件"time.h"

数据定义：

#ifndef _TM_DEFINED
struct tm {
        int tm_sec;     // 秒 – 取值区间为[0,59]；
        int tm_min;     // 分 - 取值区间为[0,59]；
        int tm_hour;    // 时 - 取值区间为[0,23]；
        int tm_mday;    // 一个月中的日期 - 取值区间为[1,31]；
        int tm_mon;     // 月份（从一月开始，0代表一月） - 取值区间为[0,11]；
        int tm_year;    // 年份，其值等于实际年份减去1900；
        int tm_wday;    // 星期 – 取值区间为[0,6]，其中0代表星期天，1代表星期一，以此类推；
        int tm_yday;    // 从每年的1月1日开始的天数 – 取值区间为[0,365]，其中0代表1月1日，1代表1月2日，以此类推；
        int tm_isdst;   // 夏令时标识符，实行夏令时的时候，tm_isdst为正。不实行夏令时的进候，tm_isdst为0；不了解情况时为负；
}
#define _TM_DEFINED
#endif

#ifndef _TIME_T_DEFINED
typedef long time_t; 
#define _TIME_T_DEFINED 
#endif

#ifndef _CLOCK_T_DEFINED
typedef long clock_t;
#define _CLOCK_T_DEFINED
#endif

time_t是长整型，用来表示从一个时间点到某一个标准时间点（一般是1970年1月1日0时0分0秒）所经历的秒数（即日历时间）。对time_t数据类型的值来说，它所表示的时间不能晚于2038年1月18日19时14分07秒。为了能够表示更久远的时间，一些编译器厂商引入了64位甚至更长的整形数来保存日历时间。

函数定义：

double difftime(time_t time1, time_t time0); // 计算时间time1和time0间的差距；
time_t mktime(struct tm * timeptr);          // 将tm结构时间转换为time_t；
time_t time(time_t * timer);                 // 获取当前日历时间；
char * asctime(const struct tm * timeptr);   // 将时间和日期以字符串格式；
char * ctime(const time_t *timer);           // 将时间和日期以字符串格式；
struct tm * gmtime(const time_t *timer);     // 将日历时间转换为标准时间（UTC）；                            
struct tm * localtime(const time_t * timer); // 将日历时间转换为本地时间；
clock_t clock( void );                       // 返回从“开启进程”到“调用clock()函数”之间的CPU时钟计时单元（clock tick）；
size_t strftime(
   char *strDest,
   size_t maxsize,
   const char *format,
   const struct tm *timeptr 
);                                           // 将时间和日期转换为用户定义格式；

strftime根据format指向字符串中格式命令把timeptr中保存的时间信息放在strDest指向的字符串中，最多向strDest中存放maxsize个字符， 类似sprintf()。

%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 时区名称，如果不能得到时区名称则返回空字符。
%% 百分号

3. 时间操作函数示例

（1）获得日历时间

Source code:

#include "time.h"
#include "stdio.h"
int main(void)
{
    time_t t = time(NULL);
    printf("The calendar time now is %d\n",t);
    return 0;
}

result:

（2）获得日期和时间

Source code:

#include "time.h"
#include "stdio.h"
int main(void)
{
    time_t lt = time(NULL);
    time_t gt = time(NULL);
    struct tm* local = localtime(<);
    struct tm* gmt   = gmtime(>);
    printf("Local hour is: %d\n", local->tm_hour);
    printf("UTC hour is: %d\n", gmt->tm_hour);
    return 0;
}

result:

P.S. 测试主机在巴黎，属于零时区

（3）格式化时间

Source code:

#include "time.h"
#include "stdio.h"
int main(void)
{
    time_t lt      = time(NULL);
    struct tm* ptr = localtime(<);
    printf(asctime(ptr));
    printf(ctime(<));
    char szBuffer[64] = {0};
    strftime(szBuffer, 64, "The local time is: %Y-%m-%d %H:%M:%S \n", ptr);
    printf("%s", szBuffer);
    return 0;
}

result:

（4）计时

Source code:

#include "stdio.h"
#include "time.h"
int main( void )
{
	long i = 10000000;
	printf( "The inteval to do %d empty loops is ", i );
	clock_t start = clock();
	while( i-- );
	clock_t finish = clock();
	printf( "%d milliseconds\n", finish - start );
}

result: