НАИМЕНОВАНИЕ

time - получить время в секундах

БИБЛИОТЕКА

Стандартная библиотека языка C (libc, -lc)

ОБЗОР

#include <time.h>

time_t time(time_t *_Nullable tloc);

ОПИСАНИЕ

time() возвращает количество секунд, которое прошло с начала эпохи, 1970-01-01 00:00:00 +0000 (UTC).

Если tloc не равно NULL, то возвращаемое значение также сохраняется в область памяти, на которую указывает tloc.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

On success, the value of time in seconds since the Epoch is returned. On error, ((time_t) -1) is returned, and errno is set to indicate the error.

ОШИБКИ

EOVERFLOW

The time cannot be represented as a time_t value. This can happen if an executable with 32-bit time_t is run on a 64-bit kernel when the time is 2038-01-19 03:14:08 UTC or later. However, when the system time is out of time_t range in other situations, the behavior is undefined.

EFAULT

tloc указывает за пределы доступного адресного пространства (однако см. ОШИБКИ).

В системах, где обёрточная функция time() библиотеки C вызывает реализацию, предоставляемую vdso(7) (то есть нет ловушки в ядре), из-за некорректного адреса может генерироваться сигнал SIGSEGV.

ВЕРСИИ

POSIX.1 defines seconds since the Epoch using a formula that approximates the number of seconds between a specified time and the Epoch. This formula takes account of the facts that all years that are evenly divisible by 4 are leap years, but years that are evenly divisible by 100 are not leap years unless they are also evenly divisible by 400, in which case they are leap years. This value is not the same as the actual number of seconds between the time and the Epoch, because of leap seconds and because system clocks are not required to be synchronized to a standard reference. Linux systems normally follow the POSIX requirement that this value ignore leap seconds, so that conforming systems interpret it consistently; see POSIX.1-2018 Rationale A.4.16.

Applications intended to run after 2038 should use ABIs with time_t wider than 32 bits; see time_t(3type).

СТАНДАРТЫ

C11, POSIX.1-2008.

ИСТОРИЯ

SVr4, 4.3BSD, C89, POSIX.1-2001.

ОШИБКИ

Ошибка, возвращаемая из этого системного вызова неотличима от успешного выполнения в случае, когда момент времени — за несколько секунд до эпохи, поэтому обёрточная функция библиотеки C никогда не изменяет errno при возврате.

Аргумент tloc устарел и в новом коде всегда должен быть равен NULL. Если tloc равно NULL, то вызов не может завершиться ошибкой.

СМОТРИТЕ ТАКЖЕ

date(1), gettimeofday(2), ctime(3), ftime(3), time(7), vdso(7)

ПЕРЕВОД

Русский перевод этой страницы руководства разработал(и) Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Yuri Kozlov <yuray@komyakino.ru>, Иван Павлов <pavia00@gmail.com> и Kirill Rekhov <krekhov.dev@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.