Функция 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 этот вызов устарел после появления
gettimeofday(2).
POSIX не указывает на наличие возможных ошибок в работе функции.