Man Pages

ftime(3) - phpMan ftime(3) - phpMan

Command: man perldoc info search(apropos)  


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



NAME
       ftime - return date and time

SYNOPSIS
       #include <sys/timeb.h>

       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  sec-
       onds  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  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 systems document, a -1 error return.)

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;  gettimeof-
       day(2) gives microseconds; clock_gettime(2) gives nanoseconds but is not as widely available.

BUGS
       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.22 of the Linux man-pages project.  A description of the project,  and  informa-
       tion about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.



GNU                               2009-03-15                          FTIME(3)