time.h
C 标准库 – <time.h> | 菜鸟教程 (runoob.com)
库变量
下面是头文件 time.h 中定义的变量类型：
序号 变量 & 描述 1 size_t
是无符号整数类型，它是 sizeof 关键字的结果。2 clock_t
这是一个适合存储处理器时间的类型。3 time_t is
这是一个适合存储日历时间类型。4 struct tm
这是一个用来保存时间和日期的结构。tm 结构的定义如下：
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 到 11 */ int tm_year; /* 自 1900 年起的年数 */ int tm_wday; /* 一周中的第几天，范围从 0 到 6 */ int tm_yday; /* 一年中的第几天，范围从 0 到 365 */ int tm_isdst; /* 夏令时 */ };
| 1 | char *asctime(const struct tm *timeptr) 返回一个指向字符串的指针，它代表了结构 timeptr 的日期和时间。 |
timeptr 是指向 tm 结构的指针。
该函数返回一个 C 字符串，包含了可读格式的日期和时间信息 Www Mmm dd hh:mm:ss yyyy，其中，Www 表示星期几，Mmm 是以字母表示的月份，dd 表示一月中的第几天，hh:mm:ss 表示时间，yyyy 表示年份。
要注意的是：
tm_mon月份是从0到11，所以0值就表示1月份，以此类推，11值就表示12月份。
tm_year是从1900年起的年数，比如如果想表示1989年，那么就给该参数赋值89。
tm_wday是从周日开始的，0表示周日，1表示周一，2表示周二，以此类推。
示例如下：
该函数可以设置任意的时间参数，并以字符串的形式输出。
| 2 | clock_t clock(void) 返回程序执行起（一般为程序的开头），处理器时钟所使用的时间。 |
根据描述可知，clock_t表示的是时钟周期个数。
为了获取 CPU 所使用的秒数，您需要除以 CLOCKS_PER_SEC。
2 CLOCKS_PER_SEC
这个宏表示每秒的处理器时钟个数。在 32 位系统中，CLOCKS_PER_SEC 等于 1000000，该函数大约每 72 分钟会返回相同的值。
该函数返回自程序启动起，处理器时钟所使用的时间。如果失败，则返回 -1 值。
clock()的实际意义是指“进程启动到调用clock()函数经过了多少CPU时钟计时单元”，借助CLOCKS_PER_SEC这个常量可以把clock_t转化为以秒为单位的数值。
| 3 | char *ctime(const time_t *timer) 返回一个表示当地时间的字符串，当地时间是基于参数 timer。 |
在C语言里，只是一个把日期和时间转换为字符串的函数。
返回的字符串格式如下： Www Mmm dd hh:mm:ss yyyy 其中，Www 表示星期几，Mmm 是以字母表示的月份，dd 表示一月中的第几天，hh:mm:ss 表示时间，yyyy 表示年份。
- timer -- 这是指向 time_t 对象的指针，该对象包含了一个日历时间。
| 4 | double difftime(time_t time1, time_t time2) 返回 time1 和 time2 之间相差的秒数 (time1-time2)。 |
这两个时间是在日历时间中指定的，表示了自纪元 Epoch（协调世界时 UTC：1970-01-01 00:00:00）起经过的时间。
- time1 -- 这是表示结束时间的 time_t 对象。
- time2 -- 这是表示开始时间的 time_t 对象。
| 5 | struct tm *gmtime(const time_t *timer) timer 的值被分解为 tm 结构，并用协调世界时（UTC）也被称为格林尼治标准时间（GMT）表示。 |
- timer -- 这是指向表示日历时间的 time_t 值的指针。
| 6 | struct tm *localtime(const time_t *timer) timer 的值被分解为 tm 结构，并用本地时区表示。 |
| 8 | size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr) 根据 format 中定义的格式化规则，格式化结构 timeptr 表示的时间，并把它存储在 str 中。 |
参数
- str -- 这是指向目标数组的指针，用来复制产生的 C 字符串。
- maxsize -- 这是被复制到 str 的最大字符数。
- format -- 这是 C 字符串，包含了普通字符和特殊格式说明符的任何组合。这些格式说明符由函数替换为表示 tm 中所指定时间的相对应值。格式说明符是：
说明符 替换为 实例 %a 缩写的星期几名称 Sun %A 完整的星期几名称 Sunday %b 缩写的月份名称 Mar %B 完整的月份名称 March %c 日期和时间表示法 Sun Aug 19 02:56:02 2012 %d 一月中的第几天（01-31） 19 %H 24 小时格式的小时（00-23） 14 %I 12 小时格式的小时（01-12） 05 %j 一年中的第几天（001-366） 231 %m 十进制数表示的月份（01-12） 08 %M 分（00-59） 55 %p AM 或 PM 名称 PM %S 秒（00-61） 02 %U 一年中的第几周，以第一个星期日作为第一周的第一天（00-53） 33 %w 十进制数表示的星期几，星期日表示为 0（0-6） 4 %W 一年中的第几周，以第一个星期一作为第一周的第一天（00-53） 34 %x 日期表示法 08/19/12 %X 时间表示法 02:50:06 %y 年份，最后两个数字（00-99） 01 %Y 年份 2012 %Z 时区的名称或缩写 CDT %% 一个 % 符号 %
- timeptr -- 这是指向 tm 结构的指针
返回值
如果产生的 C 字符串小于 size 个字符（包括空结束字符），则会返回复制到 str 中的字符总数（不包括空结束字符），否则返回零。
最常用的格式符就是这几个："%Y-%m-%d %H:%M:%S"
| 9 | time_t time(time_t *timer) 计算当前日历时间，并把它编码成 time_t 格式。 |
返回自纪元 Epoch（1970-01-01 00:00:00 UTC）起经过的时间，以秒为单位。
如果seconds不为空，则返回值也存储在变量seconds中。若为空，正常取返回值即可。
- seconds -- 这是指向类型为 time_t 的对象的指针，用来存储 seconds 的值。
示例1：
示例2：
