---

ftime(3) — Linux manual page

ftime(3) Library Functions Manual ftime(3)

NAME top

 ftime - return date and time

LIBRARY top

 Standard C library (libc, -lc)

SYNOPSIS top

 #include <sys/timeb.h>
 int ftime(struct timeb *tp);

DESCRIPTION top

 NOTE: This function is no longer provided by the GNU C library.
 Use clock_gettime(2) instead.
 This function returns the current time as seconds and milliseconds
 since the Epoch, 1970年01月01日 00:00:00 +0000 (UTC). The time is
 returned in tp, which is declared as follows:
 struct timeb {
 time_t time;
 unsigned short millitm;
 short timezone;
 short dstflag;
 };
 Here time is the number of seconds since the Epoch, and millitm is
 the number of milliseconds since time seconds since the Epoch.
 The timezone field is the local timezone measured in minutes of
 time west of Greenwich (with a negative value indicating minutes
 east of Greenwich). The dstflag field is a flag that, if nonzero,
 indicates that Daylight Saving time applies locally during the
 appropriate part of the year.
 POSIX.1-2001 says that the contents of the timezone and dstflag
 fields are unspecified; avoid relying on them.

RETURN VALUE top

 This function always returns 0. (POSIX.1-2001 specifies, and some
 systems document, a -1 error return.)

ATTRIBUTES top

 For an explanation of the terms used in this section, see
 attributes(7).
 ┌──────────────────────────────────────┬───────────────┬─────────┐
 │ Interface │ Attribute │ Value │
 ├──────────────────────────────────────┼───────────────┼─────────┤
 │ ftime() │ Thread safety │ MT-Safe │
 └──────────────────────────────────────┴───────────────┴─────────┘

STANDARDS top

 None.

HISTORY top

 Removed in glibc 2.33. 4.2BSD, POSIX.1-2001. Removed in
 POSIX.1-2008.
 This function is obsolete. Don't use it. If the time in seconds
 suffices, time(2) can be used; gettimeofday(2) gives microseconds;
 clock_gettime(2) gives nanoseconds but is not as widely available.

BUGS top

 Early glibc2 is buggy and returns 0 in the millitm field; glibc
 2.1.1 is correct again.

SEE ALSO top

 gettimeofday(2), time(2)

COLOPHON top

 This page is part of the man-pages (Linux kernel and C library
 user-space interface documentation) project. Information about
 the project can be found at 
 ⟨https://www.kernel.org/doc/man-pages/⟩. If you have a bug report
 for this manual page, see
 ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.
 This page was obtained from the tarball man-pages-6.10.tar.gz
 fetched from
 ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on
 2025年02月02日. If you discover any rendering problems in this HTML
 version of the page, or you believe there is a better or more up-
 to-date source for the page, or you have corrections or
 improvements to the information in this COLOPHON (which is not
 part of the original manual page), send a mail to
 man-pages@man7.org
Linux man-pages 6.10 2024年07月23日 ftime(3)

---

Pages that refer to this page: clock_getres(2), gettimeofday(2), syscalls(2), time(2), unimplemented(2)

---

---

---