TIME(3C-BSD)        RISC/os Reference Manual         TIME(3C-BSD)



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 argu-
     ment, as defined by <sys/timeb.h>:

          #ifndef BSD43_
          #    include <bsd43/bsd43_.h>
          #endif BSD43_


          /*
           * Structure returned by ftime system call
           */
          struct bsd43_(timeb)
          {
                   bsd43_(time_t)time;
                   unsigned short millitm;
                   shortbsd43_(timezone);
                   shortdstflag;
          };

     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 Day-
     light Saving time applies locally during the appropriate
     part of the year.

SEE ALSO
     gettimeofday(2), ctime(3).
     date(1) in the User's Reference Manual.



                         Printed 1/15/91                   Page 1