Linux程序员手册 第3部分
更新日期： 2020-02-09

名称

ftime-返回日期和时间

语法

＃包括

int ftime(struct timeb * tp);

说明

注意：不建议使用此函数，并且在以后的GNU C库版本中将删除该函数。请改用clock_gettime(2)。

此函数返回自1970年1月1日00:00:00 +0000(UTC)以来的秒数和毫秒数的当前时间。时间以tp返回，声明如下：

struct timeb {
    time_t         time;
    unsigned short millitm;
    short          timezone;
    short          dstflag;
};

这里的时间是指自纪元以来的秒数，而millitm是指自纪元以来的秒数以来的毫秒数。时区字段是以格林威治以西的时间分钟数表示的本地时区(负值表示格林威治以东的分钟数)。 dstflag字段是一个标志，如果非零，则表示夏令时在一年中的适当时间段内本地应用。

POSIX.1-2001表示时区和dstflag字段的内容未指定；避免依靠他们。

返回值

此函数始终返回0。(POSIX.1-2001指定，并且在某些系统文档中，返回-1错误。)

属性

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

遵循规范

4.2 BSD，POSIX.1-2001。 POSIX.1-2008删除了ftime()的规范。

该功能已过时。不要使用它。如果以秒为单位的时间足够，则可以使用time(2)；否则，可以使用time(2)。 gettimeofday(2)给出微秒； clock_gettime(2)可以提供纳秒级，但使用范围不广。

BUGS

早期的glibc2存在错误，在millitm字段中返回0； glibc 2.1.1再次正确。

另外参见

gettimeofday(2)，time(2)

出版信息

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