FTIME - Linux手册页

时间:2019-08-20 18:00:23  来源:igfitidea点击:

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

InterfaceAttributeValue
ftime()Thread safetyMT-Safe

遵循规范

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/