time() функция си

#include time.h>
time_t time(time_t *timer);

Эта функция определяет текущее календарное время - кодировка этого значения точна не устанавливается.
Значение

(time_t)(-1)

возвращается в случае если узнать календарное время оказывается невозможным.
Если значение переменной timer не не равно NULL , возвращаемое функцией значение также присваивается объекту , на которое указывается timer.

Description
The time function determines the current calendar time. The encoding of the value is
unspeci?ed.
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, the return value is also assigned to the object it points to