time.3 (557B)
1 .TH TIME 3 2 .SH NAME 3 time - determines 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 determines the current calendar time. 12 .SH RETURN VALUE 13 The value returned is the best approximation 14 to the current calendar time. The value 15 .B (time_t)-1 16 is returned if the calendar time is unavailable. If 17 .I timer 18 is not a null pointer, 19 the return value is also assigned to the object it points to. 20 .SH STANDARDS 21 ISO/IEC 9899:1999 Section 7.23.2.4 Paragraph 1,2,3 22 .SH SEE ALSO 23 .BR time.h (3)