Movatterモバイル変換

ftime(3) — Linux manual page

NAME \|LIBRARY \|SYNOPSIS \|DESCRIPTION \|RETURN VALUE \|ATTRIBUTES \|STANDARDS \|HISTORY \|BUGS \|SEE ALSO \|COLOPHON

ftime(3)                 Library Functions Manualftime(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.       Useclock_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 intp, which is declared as follows:           struct timeb {               time_t         time;               unsigned short millitm;               short          timezone;               short          dstflag;           };       Heretime is the number of seconds since the Epoch, andmillitm is       the number of milliseconds sincetime seconds since the Epoch.       Thetimezone field is the local timezone measured in minutes of       time west of Greenwich (with a negative value indicating minutes       east of Greenwich).  Thedstflag 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 thetimezone anddstflag       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, seeattributes(7).       ┌──────────────────────────────────────┬───────────────┬─────────┐       │Interface│Attribute│Value│       ├──────────────────────────────────────┼───────────────┼─────────┤       │ftime()                              │ Thread safety │ MT-Safe │       └──────────────────────────────────────┴───────────────┴─────────┘

STANDARDS top

       None.

HISTORY top

       4.2BSD.  Marked as LEGACY in POSIX.1-2001; removed in       POSIX.1-2008.  Removed in glibc 2.33.       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 themillitm field; glibc       2.1.1 is correct again.

COLOPHON top

       This page is part of theman-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.15.tar.gz       fetched from       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on       2025-08-11.  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 isnot       part of the original manual page), send a mail to       man-pages@man7.orgLinux man-pages 6.15            2025-06-28ftime(3)

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

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface.

For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere.

Hosting byjambit GmbH.