Предлагает средства для работы с датами и временем.
На заметку
См. также встроенные модули calendar и time, и отдельный пакеты dateutil, Pendulum, предоставляющие инструменты для работы с датой и временем.

Объекты дат и времени можно разделить на два типа: «знающие» и «наивные».

Знающие


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

Для приложений, работающих со знающими объектами, объекты datetime и time факультативно поддерживают передачу информации о временной зоне (в аргумент tzinfo можно передать экземпляр подкласса, унаследованного от tzinfo). Объекты tzinfo содержат информацию о сдвиге относительно UTC, об имени временной зоны, и о применении летнего времени.

Модуль предоставляет только одного наследника tzinfo. Этот подкласс может представлять простые временные зоны с постоянным сдвигом от UTC: это собственно UTC, а также EST и EDT зоны Северной Америки. Поддержка временных зон на более продвинутом уровне отдаётся на откуп приложениям. Правила корректировок времени в мире зачастую носят политический характер и часто меняются, поэтому вряд ли найдётся стандарт, помимо UTC, который устроил бы любое приложение.

Наивные


Наивные объекты не обладают знаниями, позволяющими непротиворечиво обнаруживать себя относительно других объектов даты и времени.
Программа, оперирующая наивными объектами должна каким-то образом сама решить, к какой временной зоне относится объект. Наивные объекты просты для понимания, потому что игнорируют перечисленные аспекты реальности, поддерживаемые «знающими» объектами.

Как различить


dateВсегда наивны
datetimeЗнающий, если: d.tzinfo is not None и d.tzinfo.utcoffset(d) is not None
timeЗнающий, если: t.tzinfo is not None и t.tzinfo.utcoffset(None) is not None
timedeltaНеприменимо

Общие свойства


Типы date, datetime, time, и timezone характеризуются следующими общими свойствами:


Константы модуля


datetime.MINYEARМинимальное значение года для объектов даты и времени. Значение: 1.
datetime.MAXYEARМаксимальное значение года для объектов даты и времени. Значение: 9999.

Синонимы поиска: datetime, датавремя, minyear, maxyear
Статьи раздела
Опции формата даты и времени Модификаторы (коды) для описания формата даты и времени.
На заметку
Зарегистрированные пользователи могут добавлять Книги.