4.3BSD - /usr/man/cat3/ftime.0

TIME(3C)                                                              TIME(3C)


NAME
       time, ftime - get date and time

SYNOPSIS
       long time(0)

       long time(tloc)
       long *tloc;

       #include <sys/types.h>
       #include <sys/timeb.h>
       ftime(tp)
       struct timeb *tp;

DESCRIPTION
       These interfaces are obsoleted by gettimeofday(2).

       Time  returns  the  time  since 00:00:00 GMT, Jan. 1, 1970, measured in
       seconds.

       If tloc is nonnull, the return value is also stored  in  the  place  to
       which tloc points.

       The  ftime  entry  fills  in a structure pointed to by its argument, as
       defined by <sys/timeb.h>:

       /* Copyright (C) 1994, 1995, 1996, 1999 Free Software Foundation, Inc.
          This file is part of the GNU C Library.

          The GNU C Library is free software; you can redistribute it and/or
          modify it under the terms of the GNU Lesser General Public
          License as published by the Free Software Foundation; either
          version 2.1 of the License, or (at your option) any later version.

          The GNU C Library is distributed in the hope that it will be useful,
          but WITHOUT ANY WARRANTY; without even the implied warranty of
          MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
          Lesser General Public License for more details.

          You should have received a copy of the GNU Lesser General Public
          License along with the GNU C Library; if not, write to the Free
          Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
          02111-1307 USA.  */

       #ifndef _SYS_TIMEB_H
       #define _SYS_TIMEB_H1

       #include <features.h>

       #define __need_time_t
       #include <time.h>


       __BEGIN_DECLS

       /* Structure returned by the ‘ftime’ function.  */

       struct timeb
         {
           time_t time;/* Seconds since epoch, as from ‘time’.  */
           unsigned short int millitm;/* Additional milliseconds.  */
           short int timezone;/* Minutes west of GMT.  */
           short int dstflag;/* Nonzero if Daylight Savings Time used.  */
         };

       /* Fill in TIMEBUF with information about the current time.  */

       extern int ftime (struct timeb *__timebuf);

       __END_DECLS

       #endif        /* sys/timeb.h */

       The structure contains the time since the epoch in seconds, up to  1000
       milliseconds of more-precise interval, the local time zone (measured in
       minutes of time westward from Greenwich), and a flag that, if  nonzero,
       indicates  that  Daylight Saving time applies locally during the appro‐
       priate part of the year.

SEE ALSO
       date(1), gettimeofday(2), settimeofday(2), ctime(3)


4th Berkeley Distribution         May 9, 1985                         TIME(3C)