time.3 (563B)
1 .TH TIME 3 2 .SH NAME 3 time - retrieve the current calendar time 4 .SH SYNOPSIS 5 #include <time.h> 6 7 time_t time(time_t *timer) 8 .SH DESCRIPTION 9 The 10 .BR time () 11 function retrieves the current calendar time from the system. 12 .SH RETURN VALUE 13 The best available approximation of the current calendar time is returned. 14 If calendar time cannot be determined, 15 .B (time_t)-1 16 is returned. 17 When 18 .I timer 19 is not a null pointer, the return value is also stored in 20 the object it points to. 21 .SH STANDARDS 22 ISO/IEC 9899:1999 Section 7.23.2.4 Paragraph 1,2,3 23 .SH SEE ALSO 24 .BR time.h (3)