FTIME(E)            Linux Programmer's Manual            FTIME(E)



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,  mil-
       litm  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.

BUGS
       This function is obsolete.  Don't use it.  If the time  in
       seconds  suffices,  time(e)  can  be used; gettimeofday(y)
       gives microseconds; clock_gettime(e) 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.

HISTORY
       The ftime() function appeared in 4.2BSD.

CONFORMING TO
       BSD 4.2, POSIX 1003.1-2001.

SEE ALSO
       gettimeofday(y), time(e)



Linux                       2001-12-14                   FTIME(E)