TIME(3V) C LIBRARY FUNCTIONS TIME(3V) NAME time, ftime - get date and time SYNOPSIS #include <sys/types.h> #include <sys/time.h> time_t time(tloc) time_t *tloc; #include <sys/timeb.h> int ftime(tp) struct timeb *tp; DESCRIPTION time() returns the time since 00:00:00 GMT, Jan. 1, 1970, measured in seconds. If tloc is non-NULL, the return value is also stored in the location to which tloc points. ftime() fills in a structure pointed to by tp, as defined in <sys/timeb.h>: 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. RETURN VALUES time() returns the value of time on success. On failure, it returns (time_t) -1. On success, ftime() returns no useful value. On failure, it returns -1. SEE ALSO date(1V), gettimeofday(2), ctime(3V)