Linux程序员手册 第3部分
更新日期： 2016-12-12

名称

timegm，timelocal-gmtime和localtime的倒数

语法

#include <time.h>

time_t timelocal(struct tm *tm);

time_t timegm(struct tm *tm);

Feature Test Macro Requirements for glibc (see
feature_test_macros(7)):

timelocal()，timegm()：
从glibc 2.19开始：
_DEFAULT_SOURCE
Glibc 2.19及更早版本：
_BSD_SOURCE _SVID_SOURCE

说明

函数timelocal()和timegm()是localtime(3)和gmtime(3)的逆函数。两种功能都需要分解时间并将其转换为日历时间(自Epoch以来的秒数，1970年1月1日00:00:00 + 0000，UTC)。这两个函数之间的区别在于，timelocal()在进行转换时会考虑本地时区，而timegm()会将输入值视为协调世界时(UTC)。

返回值

成功完成后，这些函数将返回日历时间(自大纪元以来的秒数)，表示为time_t类型的值。发生错误时，它们返回值(time_t)-1并设置errno以指示错误原因。

错误说明

EOVERFLOW

结果无法表示。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

这些功能是BSD上也存在的非标准GNU扩展。避免使用它们。

备注

timelocal()函数等效于POSIX标准函数mktime(3)。没有理由使用它。

另外参见

gmtime(3)，localtime(3)，mktime(3)，tzset(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。