• Функции в этом модуле не могут работать с временем до начала эпохи и после некоторого момента в будущем. Последняя точка определяется библиотекой языка C, лежащей в основе реализации. Для платформы UNIX это обычно 2038 год.

• Реализация библиотек Python зависит от библиотеки языка C для данной платформы, которая обычно не имеет проблем с 2000 годом, так как время представляется числом секунд, прошедших с начала эпохи. Функции, работающие с представлением времени в виде кортежа, как правило, требуют все четыре цифры года. Для совместимости с предыдущими версиями допускается использование двух цифр, если переменная accept2dyear не равна нулю. По умолчанию эта переменная равна 1, однако, если переменная окружения PYTHONY2K установлена и равна непустой строке, accept2dyear инициализируется нулем. Таким образом, Вы можете запретить использование только двух цифр, установив переменную окружения PYTHONY2K равной непустой строке.

Если представление года двумя цифрами воспринимается, оно преобразуется в соответствии со стандартами POSIX и X/Open: значения 69-99 преобразуются к 1969-1999 и 0-68 к 2000-2068. Значения 100-1899 в любом случае запрещены.

• UTC - Universal Coordinated Time, универсальное синхронизированное время, известное также как GMT (Greenwich Mean Time, среднее время по Гринвичу).

• DST - Daylight Saving Time, летнее время - корректировка часового пояса (обычно) на один час в течение части года. Правила перехода на летнее время определяются местными законами и могут меняться от года к году. Библиотека языка C имеет таблицу с локальными правилами и является в этом отношении единственным верным источником.

• Точность различных функций, работающих в реальном времени, может быть меньше, чем Вы могли бы предположить исходя из единиц, с которыми они работают.

С другой стороны, точность функций time() и sleep() выше, чем точность одноименных функций библиотеки C на платформе UNIX: время в них выражается вещественным числом, функция time() наиболее точное время (используя функцию gettimeofday() языка C, если она доступна), функция sleep() воспринимает время с ненулевой дробной частью (используя функцию select() языка C, если она доступна).

• Представление времени в виде кортежа, возвращаемое функциями gmtime() , localtime() и strptime() и воспринимаемое функциями asctime() , mktime() и strftime(), содержит 9 целочисленных элементов:

Обратите внимание, что в отличие от аналогичной структуры в языке C, значения месяцев находится в диапазоне 1-12, а не 0-11. Значение года обрабатывается так, как описано выше. Флаг коррекции для летнего времени равный -1, как правило, приводит к автоматическому выбору правильного состояния.

Модуль определяет следующие функции и объекты данных: accept2dyear

Если эта переменная не равна нулю, допускается использование представления года двумя цифрами. По умолчанию эта переменная равна 1 , однако, если переменная окружения PYTHONY2K установлена и равна непустой строке, accept2dyear инициализируется нулем. Таким образом, Вы можете запретить использование только двух цифр, установив переменную окружения PYTHONY2K равной непустой строке. Вы можете также менять значение accept2dyear во время выполнения программы.

altzone()

Сдвиг локального часового пояса с учетом перехода на летнее время в секундах на запад от UTC. Это значение всегда отрицательно, если часовой пояс находится восточнее UTC (в том числе и Россия). Используйте эту функцию, только если значение переменной daylight не равно нулю.

asctime( time tuple)

Преобразует кортеж time tuple, представляющий время (возвращается функциями gmtime() , localtime() и strptime() ), в строку из 24 символов вида Sun Jun 20 23:21:05 19 93. Обратите внимание, что в отличие от одноименной функции языка C, строка не завершается символом перехода на новую строку.

clock()

Возвращает текущее процессорное время в секундах в виде вещественного числа. Точность возвращаемого времени зависит от точности одноименной функции библиотеки языка C. Функция clock() может быть использована, например, для замера производительности.

ctime( secs)

Преобразует время secs, выраженное в секундах с начала эпохи в строку, представляющую локальное время. Эквивалентно asctime(localtime( secs)) .

daylight

Эта переменная имеет ненулевое значение, если определен часовой пояс с переходом на летнее время (DST).

gmtime( secs)

Преобразует время secs, выраженное в секундах с начала эпохи в кортеж, представляющий универсальное время (UTC).

localtime( secs)

Преобразует время secs, выраженное в секундах с начала эпохи в кортеж, представляющий локальное время. Флаг коррекции времени равен 1 (последний элемент), если применяется переход на летнее время (DST).

mktime( time tuple)

Эта функция выполняет преобразование, обратное функции localtime() . Аргумент time tuple должен быть кортежем из 9 элементов, представляющим локальное время. Для совместимости с функцией time() возвращает вещественное число. Если time tuple не представляет корректного времени, генерирует исключение OverflowError.

sleep( secs )

Приостанавливает выполнение на secs секунд. Аргумент secs может быть вещественным числом для указания более точного времени. Реальное время, на которое приостанавливается выполнение программы, может быть меньше secs, так как любой перехваченный сигнал прерывает выполнение функции sleep() , после чего выполняется обработчик сигнала. Кроме того, время может быть и больше secs из-за планирования активности различных задач системы.

strftime( format, time tuple)

Возвращает время, выраженное кортежем time tuple, в виде строки в соответствии с форматом format. Строка формата помимо обычных символов может содержать следующие управляющие последовательности (названия месяцев, дней недели и т. п. зависят от текущих национальных установок - см. описание модуля locale):