GENWiki

Premier IT Outsourcing and Support Services within the UK

User Tools

Site Tools


man:ftime

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 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  time-
     zone  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 sys-
     tems 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  suf-
     fices,   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 4.16 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/.

GNU 2017-09-15 FTIME(3)

/data/webs/external/dokuwiki/data/pages/man/ftime.txt · Last modified: 2019/05/17 09:47 by 127.0.0.1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki