The time function

Name

time -- 

Synopsis

#include <time.h>

time_t time (time_t *timer);

Description

The time function determines the current calendar time. The encoding of the value is unspecified.

Returns

The time function returns the implementation's best approximation to the current calendar time. The value (time_t)-1 is returned if the calendar time is not available. If timer is not a null pointer, then the return value is also assigned to the object it points to.

Implementation Notes

The current calendar time is held in the run-time system with a resolution of 1 second and a range of 2**32 seconds, or 136 years.
Calendar time is reset to zero each time the run-time system is restarted, where time zero is 00:00:00 on Thursday January 1, 1970.