C库函数：time.h

路溪非溪

已于 2023-03-22 14:19:33 修改

阅读量2.9k

点赞数 7

文章标签： c语言算法数据结构

于 2023-01-08 21:53:51 首次发布

本文链接：https://blog.csdn.net/qq_28576837/article/details/128600378

版权

time.h

C 标准库 – <time.h> | 菜鸟教程 (runoob.com)

库变量

下面是头文件 time.h 中定义的变量类型：

序号变量 & 描述
1 size_t
是无符号整数类型，它是 sizeof 关键字的结果。
2 clock_t
这是一个适合存储处理器时间的类型。
3 time_t is
这是一个适合存储日历时间类型。注意，日历时间就是年月日时分秒这些，不是只指年月日
4 struct tm
这是一个用来保存时间和日期的结构。

clock_t是用来保存时间的数据类型，在time.h文件中，我们可以找到对它的定义：
#ifndef _CLOCK_T_DEFINED
typedef long clock_t;
#define _CLOCK_T_DEFINED
#endif
很明显，clock_t是一个长整形数。

在time.h中，我们也可以看到time_t是一个长整型数：

其实就是时间戳。
#ifndef _TIME_T_DEFINED
typedef long time_t;    /* 时间值 */
#define _TIME_T_DEFINED /* 避免重复定义 time_t */
#endif
大家可能会产生疑问：既然time_t实际上是长整型，到未来的某一天，从一个时间点（一般是1970年1月1日0时0分0秒）到那时的秒数（即日历时间）超出了长整形所能表示的数的范围怎么办？对time_t数据类型的值来说，它所表示的时间不能晚于2038年1月18日19时14分07秒。为了能够表示更久远的时间，一些编译器厂商引入了64位甚至更长的整形数来保存日历时间。比如微软在Visual C++中采用了__time64_t数据类型来保存日历时间，并通过_time64()函数来获得日历时间（而不是通过使用32位字的time()函数），这样就可以通过该数据类型保存3001年1月1日0时0分0秒（不包括该时间点）之前的时间。

tm结构在time.h中的定义如下：
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	size_t 是无符号整数类型，它是 sizeof 关键字的结果。
2	clock_t 这是一个适合存储处理器时间的类型。
3	time_t is 这是一个适合存储日历时间类型。注意，日历时间就是年月日时分秒这些，不是只指年月日
4	struct tm 这是一个用来保存时间和日期的结构。

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 对象的指针，该对象包含了一个日历时间。

注意：这里返回的是UTC时间。

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 结构，并用本地时区表示。

localtime得到的也是UTC时间。

其实我就好奇，本地时区，函数也没指定是哪个时区，怎么能识别到呢？

Linux系统中有对时区的设置（安装系统时就选过）。

不过，有些设备上被裁减过的系统，时区没有被设置好，会导致二者转出来的时间都是0时区的。

手动匹配时区：

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"

说明符	替换为	实例
%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
%%	一个 % 符号	%

9	time_t time(time_t *seconds) 计算当前日历时间，并把它编码成 time_t 格式。

返回自纪元 Epoch（1970-01-01 00:00:00 UTC）起经过的时间，以秒为单位。

如果seconds不为空，则返回值也存储在变量seconds中。若为空，正常取返回值即可（以 time_t 对象返回当前日历时间）。感觉有点多余，就当做一种双重保障吧。

seconds -- 这是指向类型为 time_t 的对象的指针，用来存储 seconds 的值。可为空，即time(NULL)或者time(0)

示例1：

示例2：

先定义一个time_t的变量，既可以返回当前日历时间赋值给该变量，也可以直接取变量地址传入函数，同样可以存储当前日历时间。

补充

彻底弄懂GMT、UTC、时区和夏令时

理论上来说，格林尼治标准时间的正午是指当太阳横穿格林尼治子午线时（也就是在格林尼治上空最高点时）的时间。由于地球在它的椭圆轨道里的运动速度不均匀，这个时刻可能与实际的太阳时有误差，最大误差达16分钟。
由于地球每天的自转是有些不规则的，而且正在缓慢减速，因此格林尼治时间已经不再被作为标准时间使用。现在的标准时间，是由原子钟报时的协调世界时（UTC）。

CST(北京时间)

北京时间，China Standard Time，中国标准时间。在时区划分上，属东八区，比协调世界时早8小时，记为UTC+8。

早8小时，这事怎么理解呢？

如果UTC时间是中午12点，那么北京时间是几点呢？

不仔细想，好像是早上4点，这不就是早8个小时嘛。

这里其实可以这样理解：我比你要早到某个时间点。你UTC是中午12点，那么我在早8小时前就到了12点，当你到12点时，我已经12+8，也就是晚上20点了。

这就是UTC+8

注意：时区和夏令时等概念还是基于GMT的，之所以有UTC，只是提高了GMT中的时间准确度。常规意义上，可以将GMT和UTC等同。

计算机的纪元时间

关于计算机中时间的科普和八卦