time - возвращает время в секундах

НАЗВАНИЕ
time - возвращает время в секундах

СИНТАКСИС
#include

time_t time(time_t *t);

ОПИСАНИЕ
Функция time возвращает время в секундах, прошедшее с
начала этой эпохи (00:00:00 UTC, 1 Января 1970 года).
Если t не равно нулю, то возвращаемое значение будет также
сохранено в памяти структуры t.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При удачном завершении работы функции возвращается время в
секундах, прошедшее с начала этой эпохи. При ошибке
возвращается ((time_t)-1), а переменной errno
присваивается номер ошибки.

КОДЫ ОШИБОК
EFAULT t указывает на отрезок памяти, находящийся за
пределами доступного адресного пространства.

ЗАМЕЧАНИЯ
POSIX.1 определяет значение выражения секунды, прошедшие с
начала эпохи как количество секунд между заданным временем
и началом эпохи, рассчитанное по формуле преобразования
эквивалента UTC-времени в конечное время согласно naOve;
при этом игнорируются високосные секунды, а все года,
номер которых делится на 4, считаются високосными. Это
значение не является указанием на точное количество секунд
между заданным временем и началом эпохи вследствие
игнорирования високосных секунд и по причине того, что
время в часах необязательно синхронизировано со временем
стандартного источника. Есть тенденция считать, что это
значение соответствует настоящему количеству секунд,
прошедшему с начала эпохи. Смотрите POSIX.1 версии Annex
B 2.2.2, где описаны подробности этой главы.

СООТВЕТСТВИЕ СТАНДАРТАМ
SVr4, SVID, POSIX, X/OPEN, BSD 4.3.
В BSD 4.3 этот вызов устарел после появления gettimeof-
day(2). POSIX не указывает на наличие возможных ошибок в
работе функции.