4.3BSD-UWisc/man/cat3/time.3c

TIME(3C)            UNIX Programmer's Manual             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).

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

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

     The _f_t_i_m_e entry fills in a structure pointed to by its argu-
     ment, as defined by <_s_y_s/_t_i_m_e_b._h>:

     /*
      * Copyright (c) 1982, 1986 Regents of the University of California.
      * All rights reserved.  The Berkeley software License Agreement
      * specifies the terms and conditions for redistribution.
      *
      *   @(#)timeb.h7.1 (Berkeley) 6/4/86
      */
     /*
      * RCS Info
      *   $Header: timeb.h,v 3.1 86/10/22 13:29:04 tadl Exp $
      *   $Locker:  $
      */

     /*
      * Structure returned by ftime system call
      */
     struct timeb
     {
          time_t   time;
          unsigned short millitm;
          short    timezone;
          short    dstflag;
     };

     The structure contains the time since the epoch in seconds,
     up to 1000 milliseconds of more-precise interval, the local



Printed 12/27/86           May 9, 1985                          1






TIME(3C)            UNIX Programmer's Manual             TIME(3C)



     time zone (measured in minutes of time westward from
     Greenwich), and a flag that, if nonzero, indicates that Day-
     light Saving time applies locally during the appropriate
     part of the year.

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
















































Printed 12/27/86           May 9, 1985                          2