man(1) Manual page archive


     TIME(2)                                                   TIME(2)

     NAME
          time, ftime - get date and time

     SYNOPSIS
          long time((long *)0)

          long time(tloc)
          long *tloc;

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

     DESCRIPTION
          Time returns the time since the epoch 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.

          Ftime stores a more accurate time and other horological data
          in the structure pointed to by tb:

          struct timeb
          {
                  time_t time;            time since the epoch in seconds
                  unsigned short millitm; up to 1000 milliseconds of more-precise interval
                  short timezone;         local time zone measured in minutes of time
                                          westward from Greenwich
                  short dstflag;          if nonzero, daylight saving time applies locally
                                          during the appropriate part of the year
          };

     SEE ALSO
          date(1), stime(2), ctime(3)

     DIAGNOSTICS
          ftime: EFAULT

     BUGS
          If the argument to time is bogus, the user program gets a
          memory fault rather than an EFAULT.