Scroll to navigation

timegm(3) Library Functions Manual timegm(3)

ИМЯ

timegm, timelocal - обратные gmtime и localtime функции

БИБЛИОТЕКА

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

СИНТАКСИС

#include <time.h>
[[deprecated]] time_t timelocal(struct tm *tm);
time_t timegm(struct tm *tm);

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

timelocal(), timegm():


начиная с glibc 2.19:
_DEFAULT_SOURCE
в glibc 2.19 и старее:
_BSD_SOURCE || _SVID_SOURCE

ОПИСАНИЕ

timelocal() и timegm() являются обратными функциями по отношению к localtime(3) и gmtime(3). Обе функции принимают разделенное на составные части время и преобразуют его в календарное (измеряемое в секундах от начала Эпохи 1970-01-01 00:00:00 +0000, UTC). Различие между функциями заключается в том, что timelocal() во время преобразования принимает во внимание локальный часовой пояс, когда как timegm() во входном параметре использует Всемирное координированное время (Coordinated Universal Time, UTC).

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

On success, these functions return the calendar time (seconds since the Epoch), expressed as a value of type time_t. On error, they return the value (time_t) -1 and set errno to indicate the error.

ОШИБКИ

Результат не может быть представлен.

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).

Интерфейс Атрибут Значение
timelocal(), timegm() Безвредность в нитях MT-Safe env locale

СТАНДАРТЫ

BSD.

ИСТОРИЯ

GNU, BSD.

Функция timelocal() эквивалентна стандартной функции POSIX mktime(3). Нет ни одной причины когда-либо её использовать.

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

gmtime(3), localtime(3), mktime(3), tzset(3)

ПЕРЕВОД

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

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

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

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