NAME

time - get time

 SYNOPSIS

#include <time.h>

time_t time(time_t *tloc);

 DESCRIPTION

The time() function returns the value of time in seconds since the Epoch.

The tloc argument points to an area where the return value is also stored. If tloc is a null pointer, no value is stored.

 RETURN VALUE

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

 ERRORS

No errors are defined.

 EXAMPLES

None.

 APPLICATION USAGE

None.

 FUTURE DIRECTIONS

None.

 SEE ALSO

asctime(), clock(), ctime(), difftime(), gmtime(), localtime(), mktime(), strftime(), strptime(), utime(), <time.h>.

DERIVATION

Derived from Issue 1 of the SVID.