Man Ftime en anglais
FTIME(3)                   Linux Programmer's Manual                  FTIME(3)



 

NAME


       ftime - return date and time

 

SYNOPSIS


       #include 

       int ftime(struct timeb *tp);

 

DESCRIPTION






       This  function  returns  the  current time, in seconds and milliseconds
       since the Epoch (00:00:00 UTC, 1 January 1970).  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  time-
       zone  field  is the local time zone 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 non-zero, 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 sys-
       tems document, a -1 error return.)

 

CONFORMING TO


       4.2BSD, POSIX.1-2001.

 

BUGS


       This function is obsolete.  Don't use it.  If the time in seconds  suf-
       fices,   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 3.05 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/.



GNU                               2008-06-23                          FTIME(3)