2.11BSD#431 - /usr/man/cat3/time.0

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).

     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>:

     /*
      * 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
      */

     /*
      * 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
     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.


Printed 11/26/99	   May 9, 1985				1


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


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


Printed 11/26/99	   May 9, 1985				2