time() - Unix 和 Linux 系统调用

名称

time - 获取以秒为单位的时间

语法

#include <time.h>

time_t time(time_t *t);

描述

time() 返回自纪元（1970年1月1日，协调世界时00:00:00）以来的时间，以秒为单位。

如果 t 非空，则返回值也会存储在 t 指向的内存中。

返回值

成功时，返回自纪元以来的时间（以秒为单位）。发生错误时，返回 ((time_t)-1)，并且 errno 被相应地设置。

错误

标签	描述
EFAULT	t 指向您可访问的地址空间之外。

备注

POSIX.1 将自纪元以来的秒数定义为一个值，该值应解释为指定时间与纪元之间以秒为单位的时间差，根据从 UTC 转换的公式，等同于基于忽略闰秒并且所有能被 4 整除的年份都是闰年的简单转换。此值与时间与纪元之间的实际秒数不同，因为存在闰秒，并且时钟不需要与标准参考同步。目的是使自纪元以来的秒数值的解释保持一致；有关更多基本原理，请参阅 POSIX.1 附录 B 2.2.2。

符合标准

SVr4、4.3BSD、POSIX.1-2001。
在 4.3BSD 下，此调用被gettimeofday(2) 取代。POSIX 未指定任何错误条件。

参见

打印页面