NAME

time − get system time

SYNOPSIS

#include <time.h>

time_t time(time_t ∗tloc);

(NOT AVAILABLE IN POSIX)

#include <sys/types.h>
#include <sys/timeb.h>

ftime(struct timeb ∗tp);

DESCRIPTION

For non-POSIX applications, these interfaces are obsoleted by gettimeofday(2). 

Time returns the value of time in seconds since 00:00:00 GMT, January 1, 1970. 

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

The BSD ftime function fills in a structure pointed to by its argument, as defined in <sys/timeb.h>. 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 Daylight Saving time applies locally during the appropriate part of the year.

RETURN VALUE

Upon successful completion, time returns the value of time.  Otherwise, a value of (( time_t )−1) is returned. 

SEE ALSO

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

4th Berkeley Distribution  —  August 1, 1992