1.TH TIME 3 scc\-VERSION2.SH NAME3time - retrieve the current calendar time4.SH SYNOPSIS5#include <time.h>67time_t time(time_t *timer)8.SH DESCRIPTION9The10.BR time ()11function retrieves the current calendar time from the system.12.SH RETURN VALUE13The best available approximation of the current calendar time is returned.14If calendar time cannot be determined,15.B (time_t)-116is returned.17When18.I timer19is not a null pointer, the return value is also stored in20the object it points to.21.SH STANDARDS22ISO/IEC 9899:1999 Section 7.23.2.4 Paragraph 1,2,323.SH SEE ALSO24.BR time.h (3)