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–2068UTC (Coordinated Universal Time)- это всемирное координированное время (ранее известное как среднее время по Гринвичу или GMT (Greenwich Mean Time)). Аббревиатура UTC - это не ошибка, а компромисс между английским и французским языками
DST (Daylight Saving Time) - это переход на летнее время, изменение часового пояса (обычно) на один час в течение части года. Правила перехода на летнее время определяются местным законодательством и могут меняться из года в год. В библиотеке C есть таблица, содержащая локальные правила (часто она читается из системного файла для гибкости), и в этом отношении она является единственным источником истинной мудрости
Точность различных функций реального времени может быть меньше, чем предполагают единицы, в которых выражено их значение или аргумент. Например, в большинстве систем Unix часы «тикают» только 50 или 100 раз в секунду
С другой стороны, точность time () и sleep () лучше, чем их эквиваленты в Unix: время выражается в виде чисел с плавающей запятой, time () возвращает наиболее точное доступное время (используя Unix
gettimeofday ()
, где это возможно), и sleep () примет время с ненулевой дробью (для реализации этого используется Unixselect ()
, если это возможно)Значение времени, возвращаемое функциями 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_timetm_gmtoff
иtm_zone
теперь доступны на всех платформах.Используйте следующие функции для преобразования между представлениями времени:
Из | В | Используйте |
секунды с начала эпохи | struct_time в UTC | |
секунды с начала эпохи | struct_time по местному времени | |
struct_time в UTC | секунды с начала эпохи | |
struct_time по местному времени | секунды с начала эпохи |
time.asctime () - преобразует кортеж или struct_time в строку, представляющую время
не заполнено...
time.ctime () - конвертирует секунды с начала эпохи в строку, представляющую время
time.get_clock_info ()
time.gmtime () - конвертирует секунды с начала эпохи в формат UTC
time.localtime () - конвертирует секунды с начала эпохи в формат местного времени
не заполнено...
time.sleep () - приостанавливает выполнение потока на заданное число секунд
не заполнено...
time.time () - возвращает время в секундах, прошедшее с начала эпохи Unix
не заполнено...
Last updated