Provided by: manpages-dev_2.77-1_all bug

NAME

       ftime - return date and time

SYNOPSIS

       #include <sys/timeb.h>

       int ftime(struct timeb *tp);

DESCRIPTION

       Return current date and time 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, millitm is the
       number of milliseconds since time seconds since the Epoch, timezone  is
       the  local time zone measured in minutes of time west of Greenwich, and
       dstflag is a flag that, if nonzero, indicates that Daylight Saving time
       applies locally during the appropriate part of the year.

       These  days  the  contents  of  the  timezone  and  dstflag  fields are
       undefined.

RETURN VALUE

       This function always returns 0.

CONFORMING TO

       4.2BSD, POSIX.1-2001.

BUGS

       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(3) gives nanoseconds but is not yet widely available.

       Under libc4 and libc5 the  millitm  field  is  meaningful.   But  early
       glibc2 is buggy and returns 0 there; glibc 2.1.1 is correct again.

SEE ALSO

       gettimeofday(2), time(2)

COLOPHON

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