TIMEGM - Linux手册页

时间:2019-08-20 18:01:31  来源:igfitidea点击:

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)。

InterfaceAttributeValue
timelocal(),timegm()Thread safetyMT-Safe env locale

遵循规范

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

备注

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

另外参见

gmtime(3),localtime(3),mktime(3),tzset(3)

出版信息

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