> For the complete documentation index, see [llms.txt](https://treasuremaster.gitbook.io/python-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://treasuremaster.gitbook.io/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time.md).

# time

### Доступ к времени и его преобразования

Этот модуль предоставляет различные функции, связанные со временем. Для связанных функций см. также модули [datetime](/python-docs/moduli-standartnoi-biblioteki-1/specialnye-tipy-dannykh/datetime.md) и [calendar](/python-docs/moduli-standartnoi-biblioteki-1/specialnye-tipy-dannykh/calendar.md).

Хотя этот модуль доступен всегда, не все функции доступны на всех платформах. Большинство функций, определенных в этом модуле, вызывают функции библиотеки C с тем же именем. Иногда может быть полезно обратиться к документации платформы, поскольку семантика этих функций различается для разных платформ.

Необходимо пояснение некоторых терминов и условностей.

* ***epoch*** - это точка, в которой время начинается, и зависит от платформы. Для Unix эпоха - 1 января 1970 г., 00:00:00 (UTC). Чтобы узнать, какая эпоха на данной платформе, посмотрите на `time.gmtime (0)`
* Термин «[секунды с начала эпохи](https://en.wikipedia.org/wiki/Leap_second)» относится к общему количеству секунд, прошедших с начала эпохи, обычно без учета дополнительных секунд. Дополнительные секунды исключаются из этого общего количества на всех POSIX-совместимых платформах
* Функции в этом модуле могут не обрабатывать даты и время до эпохи или далеко в будущем. Точка отсечения в будущем определяется библиотекой C; для 32-битных систем это обычно 2038 год
* Функция [strptime ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.strptime.md) может анализировать 2-значные годы при заданном коде формата `%y`. При анализе двухзначных лет они преобразуются в соответствии со стандартами POSIX и ISO C: значения 69–99 отображаются в 1969–1999, а значения 0–68 отображаются в 2000–2068
* UTC (Coordinated Universal Time)- это всемирное координированное время (ранее известное как среднее время по Гринвичу или GMT (Greenwich Mean Time)). Аббревиатура UTC - это не ошибка, а компромисс между английским и французским языками
* DST (Daylight Saving Time) - это переход на летнее время, изменение часового пояса (обычно) на один час в течение части года. Правила перехода на летнее время определяются местным законодательством и могут меняться из года в год. В библиотеке C есть таблица, содержащая локальные правила (часто она читается из системного файла для гибкости), и в этом отношении она является единственным источником истинной мудрости
* Точность различных функций реального времени может быть меньше, чем предполагают единицы, в которых выражено их значение или аргумент. Например, в большинстве систем Unix часы «тикают» только 50 или 100 раз в секунду
* С другой стороны, точность [time ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.time.md) и [sleep ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.sleep.md) лучше, чем их эквиваленты в Unix: время выражается в виде чисел с плавающей запятой, [time ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.time.md) возвращает наиболее точное доступное время (используя Unix `gettimeofday ()`, где это возможно), и [sleep ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.sleep.md) примет время с ненулевой дробью (для реализации этого используется Unix `select ()`, если это возможно)
* Значение времени, возвращаемое функциями [gmtime ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.gmtime.md), [localtime ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.localtime.md) и [strptime ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.strptime.md) и принимаемое [asctime ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.asctime.md), [mktime ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.mktime.md) и [strftime ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.strftime.md), представляет собой последовательность из 9 целых чисел. Возвращаемые значения [gmtime ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.gmtime.md), [localtime ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.localtime.md) и [strptime ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.strptime.md) также предлагают имена атрибутов для отдельных полей. См. [struct\_time](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.struct_time.md) для описания этих объектов. *Изменено в версии 3.3:* тип [struct\_time](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.struct_time.md) был расширен для предоставления атрибутов `tm_gmtoff` и `tm_zone`, когда платформа поддерживает соответствующие элементы `struct tm`. *Изменено в версии 3.6:* атрибуты [struct\_time](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.struct_time.md) `tm_gmtoff` и `tm_zone` теперь доступны на всех платформах.
* Используйте следующие функции для преобразования между представлениями времени:

| Из                                                                                                                                                         | В                                                                                                                                                          | Используйте                                                                                                                              |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| секунды с начала эпохи                                                                                                                                     | [struct\_time](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.struct_time.md) в UTC               | [gmtime ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.gmtime.md)           |
| секунды с начала эпохи                                                                                                                                     | [struct\_time](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.struct_time.md) по местному времени | [localtime ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.localtime.md)     |
| [struct\_time](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.struct_time.md) в UTC               | секунды с начала эпохи                                                                                                                                     | [calendar.timegm ()](/python-docs/moduli-standartnoi-biblioteki-1/specialnye-tipy-dannykh/calendar/calendar.calendar/calendar.timegm.md) |
| [struct\_time](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.struct_time.md) по местному времени | секунды с начала эпохи                                                                                                                                     | [mktime ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.mktime.md)           |

### [Функции time](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time.md)

* [time.asctime ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.asctime.md) - преобразует кортеж или struct\_time в строку, представляющую время
* не заполнено...
* [time.ctime ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.ctime.md) - конвертирует секунды с начала эпохи в строку, представляющую время
* time.get\_clock\_info ()
* [time.gmtime ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.gmtime.md) - конвертирует секунды с начала эпохи в формат UTC
* [time.localtime ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.localtime.md) - конвертирует секунды с начала эпохи в формат местного времени
* не заполнено...
* [time.sleep ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.sleep.md) - приостанавливает выполнение потока на заданное число секунд
* не заполнено...
* [time.time ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/time/funkcii-time/time.time.md) - возвращает время в секундах, прошедшее с начала эпохи Unix
* не заполнено...