focal (3) ftime.3.gz

NAME

       ftime - return date and time

SYNOPSIS

       #include <sys/timeb.h>

       int ftime(struct timeb *tp);

DESCRIPTION

       NOTE:  This  function  is  deprecated, and will be removed in a future version of 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

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

ATTRIBUTES

       For an explanation of the terms used in this section, see attributes(7).

       ┌──────────┬───────────────┬─────────┐
       │Interface │ Attribute     │ Value   │
       ├──────────┼───────────────┼─────────┤
       │ftime()   │ Thread safety │ MT-Safe │
       └──────────┴───────────────┴─────────┘

CONFORMING TO

       4.2BSD, POSIX.1-2001.  POSIX.1-2008 removes the specification of ftime().

       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

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

SEE ALSO

       gettimeofday(2), time(2)

COLOPHON

       This  page  is  part  of  release  5.05  of  the  Linux man-pages project.  A description of the project,
       information  about  reporting  bugs,  and  the  latest  version  of  this   page,   can   be   found   at
       https://www.kernel.org/doc/man-pages/.