time

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

Этот модуль предоставляет различные функции, связанные со временем. Для связанных функций см. также модули datetime и calendar.

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

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

• epoch - это точка, в которой время начинается, и зависит от платформы. Для Unix эпоха - 1 января 1970 г., 00:00:00 (UTC). Чтобы узнать, какая эпоха на данной платформе, посмотрите на time.gmtime (0)

• Термин «секунды с начала эпохи» относится к общему количеству секунд, прошедших с начала эпохи, обычно без учета дополнительных секунд. Дополнительные секунды исключаются из этого общего количества на всех POSIX-совместимых платформах

• Функции в этом модуле могут не обрабатывать даты и время до эпохи или далеко в будущем. Точка отсечения в будущем определяется библиотекой C; для 32-битных систем это обычно 2038 год

• Функция strptime () может анализировать 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 () и sleep () лучше, чем их эквиваленты в Unix: время выражается в виде чисел с плавающей запятой, time () возвращает наиболее точное доступное время (используя Unix gettimeofday (), где это возможно), и sleep () примет время с ненулевой дробью (для реализации этого используется Unix select (), если это возможно)

• Значение времени, возвращаемое функциями gmtime (), localtime () и strptime () и принимаемое asctime (), mktime () и strftime (), представляет собой последовательность из 9 целых чисел. Возвращаемые значения gmtime (), localtime () и strptime () также предлагают имена атрибутов для отдельных полей. См. struct_time для описания этих объектов. Изменено в версии 3.3: тип struct_time был расширен для предоставления атрибутов tm_gmtoff и tm_zone, когда платформа поддерживает соответствующие элементы struct tm. Изменено в версии 3.6: атрибуты struct_time tm_gmtoff и tm_zone теперь доступны на всех платформах.

• Используйте следующие функции для преобразования между представлениями времени:

Из	В	Используйте
секунды с начала эпохи	struct_time в UTC	gmtime ()
секунды с начала эпохи	struct_time по местному времени	localtime ()
struct_time в UTC	секунды с начала эпохи	calendar.timegm ()
struct_time по местному времени	секунды с начала эпохи	mktime ()

Функции time

• time.asctime () - преобразует кортеж или struct_time в строку, представляющую время

• не заполнено...

• time.ctime () - конвертирует секунды с начала эпохи в строку, представляющую время

• time.get_clock_info ()

• time.gmtime () - конвертирует секунды с начала эпохи в формат UTC

• time.localtime () - конвертирует секунды с начала эпохи в формат местного времени

• не заполнено...

• time.sleep () - приостанавливает выполнение потока на заданное число секунд

• не заполнено...

• time.time () - возвращает время в секундах, прошедшее с начала эпохи Unix

• не заполнено...