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

       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).

   Отличия между библиотекой C и ядром
       На некоторых архитектурах реализация time() находится в vdso(7).

СТАНДАРТЫ

       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 или
       более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

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

Справочные страницы Linux 6.9.1                   2 мая 2024 г.                                          time(2)