datetime.md

1> **Источник:** https://python-all.ru/3.12/library/datetime.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# `datetime` – Основные типы даты и времени89**Исходный код:** [Lib/datetime.py](https://python-all.ru/src/3.12/Lib/datetime.py)1011---1213Модуль `datetime` предоставляет классы для работы с датами и временем.1415Хотя арифметика дат и времени поддерживается, основное внимание в реализации уделяется эффективному извлечению атрибутов для форматирования и обработки вывода.1617> **Совет**18>19> Перейти к [кодам форматирования](https://python-all.ru/3.12/library/datetime.html#format-codes).2021> **См. также**22>23> **Модуль [`calendar`](https://python-all.ru/3.12/library/calendar.html#module-calendar)**24>25> Общие функции, связанные с календарём.26>27> **Модуль [`time`](https://python-all.ru/3.12/library/time.html#module-time)**28>29> Доступ к времени и преобразования.30>31> **Модуль [`zoneinfo`](https://python-all.ru/3.12/library/zoneinfo.html#module-zoneinfo)**32>33> Конкретные часовые пояса, представляющие базу данных часовых поясов IANA.34>35> **Пакет [dateutil](https://python-all.ru/3.12/library/datetime.html)**36>37> Сторонняя библиотека с расширенной поддержкой часовых поясов и разбора.38>39> **Пакет [DateType](https://python-all.ru/3.12/library/datetime.html)**40>41> Сторонняя библиотека, которая вводит отдельные статические типы, позволяя, например, [статическим проверкам типов](https://python-all.ru/3.12/glossary.html#term-static-type-checker) различать наивные и осведомлённые объекты datetime.4243## Осведомлённые и наивные объекты4445Объекты даты и времени могут быть отнесены к категории «осведомлённых» или «наивных» в зависимости от того, содержат ли они информацию о часовом поясе.4647При достаточном знании применимых алгоритмических и политических поправок времени, таких как информация о часовом поясе и переходе на летнее время, **осведомлённый** объект может определить своё положение относительно других осведомлённых объектов. Осведомлённый объект представляет конкретный момент времени, не допускающий неоднозначного толкования. [\[1\]](https://python-all.ru/3.12/library/datetime.html#id4)4849**Наивный** объект не содержит достаточно информации, чтобы однозначно определить своё положение относительно других объектов даты/времени. Представляет ли наивный объект Всемирное координированное время (UTC), местное время или время в другом часовом поясе – это полностью зависит от программы, так же как от программы зависит, представляет ли конкретное число метры, мили или массу. Наивные объекты легко понять и использовать, ценой игнорирования некоторых аспектов реальности.5051Для приложений, требующих осведомлённых объектов, объекты [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) и [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) имеют необязательный атрибут информации о часовом поясе `tzinfo`, который может быть установлен в экземпляр подкласса абстрактного класса [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo). Эти объекты [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) содержат информацию о смещении от UTC, названии часового пояса и о том, действует ли летнее время.5253Только один конкретный класс [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo), класс [`timezone`](https://python-all.ru/3.12/library/datetime.html#datetime.timezone), предоставляется модулем `datetime`. Класс `timezone` может представлять простые часовые пояса с фиксированным смещением от UTC, такие как сам UTC или часовые пояса североамериканских EST и EDT. Поддержка часовых поясов с более глубоким уровнем детализации оставляется на усмотрение приложения. Правила корректировки времени в мире более политизированы, чем рациональны, часто меняются, и не существует стандарта, подходящего для всех приложений, кроме UTC.5455## Константы5657Модуль `datetime` экспортирует следующие константы:5859#### `datetime.MINYEAR`6061Наименьший номер года, допустимый в объекте [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date) или [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime). [`MINYEAR`](https://python-all.ru/3.12/library/datetime.html#datetime.MINYEAR) равен 1.6263#### `datetime.MAXYEAR`6465Наибольший номер года, допустимый в объекте [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date) или [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime). [`MAXYEAR`](https://python-all.ru/3.12/library/datetime.html#datetime.MAXYEAR) равен 9999.6667#### `datetime.UTC`6869Псевдоним для синглтона часового пояса UTC [`datetime.timezone.utc`](https://python-all.ru/3.12/library/datetime.html#datetime.timezone.utc).7071Добавлено в версии 3.12.7273## Доступные типы7475#### `class datetime.date`7677Идеализированная наивная дата, предполагающая, что текущий григорианский календарь действовал всегда и будет действовать всегда. Атрибуты: [`year`](https://python-all.ru/3.12/library/datetime.html#datetime.date.year), [`month`](https://python-all.ru/3.12/library/datetime.html#datetime.date.month) и [`day`](https://python-all.ru/3.12/library/datetime.html#datetime.date.day).7879#### `class datetime.time`8081Идеализированное время, независимое от какого-либо конкретного дня, предполагающее, что каждый день содержит ровно 24\*60\*60 секунд. (Здесь нет понятия «високосные секунды».) Атрибуты: [`hour`](https://python-all.ru/3.12/library/datetime.html#datetime.time.hour), [`minute`](https://python-all.ru/3.12/library/datetime.html#datetime.time.minute), [`second`](https://python-all.ru/3.12/library/datetime.html#datetime.time.second), [`microsecond`](https://python-all.ru/3.12/library/datetime.html#datetime.time.microsecond) и [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.time.tzinfo).8283#### `class datetime.datetime`8485Комбинация даты и времени. Атрибуты: [`year`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.year), [`month`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.month), [`day`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.day), [`hour`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.hour), [`minute`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.minute), [`second`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.second), [`microsecond`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.microsecond), и [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo).8687#### `class datetime.timedelta`8889Длительность, представляющая разницу между двумя экземплярами [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) или [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date) с точностью до микросекунды.9091#### `class datetime.tzinfo`9293Абстрактный базовый класс для объектов информации о часовых поясах. Они используются классами [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) и [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) для предоставления настраиваемого понятия коррекции времени (например, для учёта часового пояса и/или летнего времени).9495#### `class datetime.timezone`9697Класс, реализующий абстрактный базовый класс [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) в виде фиксированного смещения от UTC.9899Добавлено в версии 3.2.100101Объекты этих типов неизменяемы.102103Отношения подклассов:104105```python106object107    timedelta108    tzinfo109        timezone110    time111    date112        datetime113```114115### Общие свойства116117Типы [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date), [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime), [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) и [`timezone`](https://python-all.ru/3.12/library/datetime.html#datetime.timezone) имеют следующие общие особенности:118119- Объекты этих типов неизменяемы.120- Объекты этих типов являются [хешируемыми](https://python-all.ru/3.12/glossary.html#term-hashable), то есть могут использоваться в качестве ключей словаря.121- Объекты этих типов поддерживают эффективную сериализацию с помощью модуля [`pickle`](https://python-all.ru/3.12/library/pickle.html#module-pickle).122123### Определение, является ли объект осведомлённым или наивным124125Объекты типа [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date) всегда naive.126127Объект типа [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) или [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) может быть aware или naive.128129Объект [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) `d` является aware, если выполняются оба следующих условия:1301311. `d.tzinfo` не является `None`1322. `d.tzinfo.utcoffset(d)` не возвращает `None`133134В противном случае `d` является naive.135136Объект [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) `t` является aware, если выполняются оба следующих условия:1371381. `t.tzinfo` не является `None`1392. `t.tzinfo.utcoffset(None)` не возвращает `None`.140141В противном случае `t` является naive.142143Различие между aware и naive не применимо к объектам [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) .144145## [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) Объекты146147Объект [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) представляет длительность, разницу между двумя экземплярами [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) или [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date).148149#### `class datetime.timedelta(days=0, seconds=0, microseconds=0, milliseconds=0, minutes=0, hours=0, weeks=0)`150151Все аргументы необязательны и по умолчанию равны 0. Аргументы могут быть целыми числами или числами с плавающей запятой, а также могут быть положительными или отрицательными.152153Внутри хранятся только *days*, *seconds* и *microseconds*. Аргументы преобразуются в эти единицы:154155- Миллисекунда преобразуется в 1000 микросекунд.156- Минута преобразуется в 60 секунд.157- Час преобразуется в 3600 секунд.158- Неделя преобразуется в 7 дней.159160а затем дни, секунды и микросекунды нормализуются так, что представление уникально, с161162- `0 <= microseconds < 1000000`163- `0 <= seconds < 3600*24` (количество секунд в одном дне)164- `-999999999 <= days <= 999999999`165166Следующий пример показывает, как любые аргументы, кроме *days*, *seconds* и *microseconds*, «объединяются» и нормализуются в эти три результирующих атрибута:167168```python169>>> from datetime import timedelta170>>> delta = timedelta(171...     days=50,172...     seconds=27,173...     microseconds=10,174...     milliseconds=29000,175...     minutes=5,176...     hours=8,177...     weeks=2178... )179>>> # Остаются только дни, секунды и микросекунды180>>> delta181datetime.timedelta(days=64, seconds=29156, microseconds=10)182```183184Если какой-либо аргумент является числом с плавающей запятой и есть дробные микросекунды, то дробные микросекунды, оставшиеся от всех аргументов, объединяются, и их сумма округляется до ближайшей микросекунды с использованием правила округления до ближайшего чётного. Если ни один аргумент не является числом с плавающей запятой, процессы преобразования и нормализации являются точными (информация не теряется).185186Если нормализованное значение дней выходит за указанный диапазон, возбуждается [`OverflowError`](https://python-all.ru/3.12/library/exceptions.html#OverflowError).187188Обратите внимание, что нормализация отрицательных значений может сначала показаться неожиданной. Например:189190```python191>>> from datetime import timedelta192>>> d = timedelta(microseconds=-1)193>>> (d.days, d.seconds, d.microseconds)194(-1, 86399, 999999)195```196197Атрибуты класса:198199#### `timedelta.min`200201Наиболее отрицательный объект [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta), `timedelta(-999999999)`.202203#### `timedelta.max`204205Наиболее положительный объект [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta), `timedelta(days=999999999, hours=23, minutes=59, seconds=59, microseconds=999999)`.206207#### `timedelta.resolution`208209Наименьшая возможная разница между неравными [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) объектами, `timedelta(microseconds=1)`.210211Обратите внимание, что из-за нормализации `timedelta.max` больше, чем `-timedelta.min`. `-timedelta.max` не представим как объект [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta).212213Атрибуты экземпляра (только для чтения):214215#### `timedelta.days`216217От -999,999,999 до 999,999,999 включительно.218219#### `timedelta.seconds`220221От 0 до 86,399 включительно.222223> **Внимание**224>225> Это довольно распространённая ошибка, когда код непреднамеренно использует этот атрибут, хотя на самом деле предполагается получить значение [`total_seconds()`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta.total_seconds) вместо этого:226>227> ```pycon228> >>> from datetime import timedelta229> >>> duration = timedelta(seconds=11235813)230> >>> duration.days, duration.seconds231> (130, 3813)232> >>> duration.total_seconds()233> 11235813.0234> ```235236#### `timedelta.microseconds`237238От 0 до 999,999 включительно.239240Поддерживаемые операции:241242| Операция | Результат |243| --- | --- |244| `t1 = t2 + t3` | Сумма `t2` и `t3`. После этого `t1 - t2 == t3` и `t1 - t3 == t2` истинны. (1) |245| `t1 = t2 - t3` | Разность `t2` и `t3`. После этого `t1 == t2 - t3` и `t2 == t1 + t3` истинны. (1)(6) |246| `t1 = t2 * i or t1 = i * t2` | Дельта, умноженная на целое число. После этого `t1 // i == t2` истинно, при условии `i != 0`. |247|  | В общем случае `t1 * i == t1 * (i-1) + t1` истинно. (1) |248| `t1 = t2 * f or t1 = f * t2` | Дельта, умноженная на число с плавающей запятой. Результат округляется до ближайшего кратного timedelta.resolution по правилу round-half-to-even. |249| `f = t2 / t3` | Деление (3) общей длительности `t2` на единицу интервала `t3`. Возвращает объект [`float`](https://python-all.ru/3.12/library/functions.html#float). |250| `t1 = t2 / f or t1 = t2 / i` | Дельта, делённая на число с плавающей запятой или целое число. Результат округляется до ближайшего кратного timedelta.resolution по правилу round-half-to-even. |251| `t1 = t2 // i` или `t1 = t2 // t3` | Вычисляется целая часть, а остаток (если он есть) отбрасывается. Во втором случае возвращается целое число. (3) |252| `t1 = t2 % t3` | Остаток вычисляется как объект [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta). (3) |253| `q, r = divmod(t1, t2)` | Вычисляет частное и остаток: `q = t1 // t2` (3) и `r = t1 % t2`. `q` – целое число, а `r` – объект [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta). |254| `+t1` | Возвращает объект [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) с тем же значением. (2) |255| `-t1` | Эквивалентно `timedelta(-t1.days, -t1.seconds, -t1.microseconds)` и `t1 * -1`. (1)(4) |256| `abs(t)` | Эквивалентно `+t`, когда `t.days >= 0`, и `-t`, когда `t.days < 0`. (2) |257| `str(t)` | Возвращает строку вида `[D day[s], ][H]H:MM:SS[.UUUUUU]`, где D отрицательно для отрицательного `t`. (5) |258| `repr(t)` | Возвращает строковое представление объекта [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) в виде вызова конструктора с каноническими значениями атрибутов. |259260Примечания:2612621. Это точное, но может привести к переполнению.2632. Это точное и не может привести к переполнению.2643. Деление на ноль вызывает [`ZeroDivisionError`](https://python-all.ru/3.12/library/exceptions.html#ZeroDivisionError).2654. `-timedelta.max` не представимо в виде объекта [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta).2665. Строковые представления [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) объектов нормализуются аналогично их внутреннему представлению. Это приводит к несколько необычным результатам для отрицательных объектов timedelta. Например:267268   ```python269   >>> timedelta(hours=-5)270   datetime.timedelta(days=-1, seconds=68400)271   >>> print(_)272   -1 day, 19:00:00273   ```2746. Выражение `t2 - t3` всегда будет равно выражению `t2 + (-t3)`, за исключением случая, когда t3 равно `timedelta.max`; в этом случае первое выражение даст результат, а второе вызовет переполнение.275276В дополнение к перечисленным выше операциям, объекты [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) поддерживают некоторые операции сложения и вычитания с объектами [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date) и [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) (см. ниже).277278Изменено в версии 3.2: Теперь поддерживаются целочисленное деление и истинное деление объекта [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) на другой объект [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta), а также операции взятия остатка и функция [`divmod()`](https://python-all.ru/3.12/library/functions.html#divmod). Также теперь поддерживаются истинное деление и умножение объекта [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) на объект [`float`](https://python-all.ru/3.12/library/functions.html#float).279280Объекты [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) поддерживают сравнение на равенство и упорядочивание.281282В логических контекстах объект [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) считается истинным тогда и только тогда, когда он не равен `timedelta(0)`.283284Методы экземпляра:285286#### `timedelta.total_seconds()`287288Возвращает общее количество секунд, содержащихся в интервале. Эквивалентно `td / timedelta(seconds=1)`. Для единиц интервала, отличных от секунд, используйте форму деления напрямую (например, `td / timedelta(microseconds=1)`).289290Обратите внимание, что для очень больших временных интервалов (более 270 лет на большинстве платформ) этот метод теряет точность до микросекунд.291292Добавлено в версии 3.2.293294### Примеры использования: [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta)295296Дополнительный пример нормализации:297298```python299>>> # Компоненты another_year в сумме составляют ровно 365 дней300>>> from datetime import timedelta301>>> year = timedelta(days=365)302>>> another_year = timedelta(weeks=40, days=84, hours=23,303...                          minutes=50, seconds=600)304>>> year == another_year305True306>>> year.total_seconds()30731536000.0308```309310Примеры арифметики [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta):311312```python313>>> from datetime import timedelta314>>> year = timedelta(days=365)315>>> ten_years = 10 * year316>>> ten_years317datetime.timedelta(days=3650)318>>> ten_years.days // 36531910320>>> nine_years = ten_years - year321>>> nine_years322datetime.timedelta(days=3285)323>>> three_years = nine_years // 3324>>> three_years, three_years.days // 365325(datetime.timedelta(days=1095), 3)326```327328## [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date) Объекты329330Объект [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date) представляет дату (год, месяц и день) в идеализированном календаре – текущем григорианском календаре, бесконечно расширенном в обе стороны.3313321 января 1 года называется днём номер 1, 2 января 1 года – днём номер 2 и так далее. [\[2\]](https://python-all.ru/3.12/library/datetime.html#id5)333334#### `class datetime.date(year, month, day)`335336Все аргументы обязательны. Аргументы должны быть целыми числами в следующих диапазонах:337338- `MINYEAR <= year <= MAXYEAR`339- `1 <= month <= 12`340- `1 <= day <= number of days in the given month and year`341342Если указан аргумент вне этих диапазонов, возбуждается [`ValueError`](https://python-all.ru/3.12/library/exceptions.html#ValueError).343344Другие конструкторы – все методы класса:345346#### `classmethod date.today()`347348Возвращает текущую локальную дату.349350Это эквивалентно `date.fromtimestamp(time.time())`.351352#### `classmethod date.fromtimestamp(timestamp)`353354Возвращает локальную дату, соответствующую метке времени POSIX, такую, как возвращает функция [`time.time()`](https://python-all.ru/3.12/library/time.html#time.time).355356Это может вызвать [`OverflowError`](https://python-all.ru/3.12/library/exceptions.html#OverflowError), если метка времени находится за пределами диапазона значений, поддерживаемого функцией C `localtime()` платформы, и [`OSError`](https://python-all.ru/3.12/library/exceptions.html#OSError) при ошибке `localtime()`. Обычно это ограничивается годами с 1970 по 2038. Обратите внимание, что в системах, не соответствующих POSIX, которые включают високосные секунды в своё представление метки времени, високосные секунды игнорируются функцией [`fromtimestamp()`](https://python-all.ru/3.12/library/datetime.html#datetime.date.fromtimestamp).357358Изменено в версии 3.3: Вызывает [`OverflowError`](https://python-all.ru/3.12/library/exceptions.html#OverflowError) вместо [`ValueError`](https://python-all.ru/3.12/library/exceptions.html#ValueError), если метка времени выходит за пределы диапазона значений, поддерживаемого функцией `localtime()` платформы C. Вызывает [`OSError`](https://python-all.ru/3.12/library/exceptions.html#OSError) вместо [`ValueError`](https://python-all.ru/3.12/library/exceptions.html#ValueError) при ошибке `localtime()`.359360#### `classmethod date.fromordinal(ordinal)`361362Возвращает дату, соответствующую пролептическому григорианскому порядковому номеру, где 1 января 1 года имеет порядковый номер 1.363364[`ValueError`](https://python-all.ru/3.12/library/exceptions.html#ValueError) вызывается, если только `1 <= ordinal <= date.max.toordinal()`. Для любой даты `d`, `date.fromordinal(d.toordinal()) == d`.365366#### `classmethod date.fromisoformat(date_string)`367368Возвращает [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date), соответствующий *date\_string*, заданной в любом допустимом формате ISO 8601, за следующими исключениями:3693701. Даты с пониженной точностью в настоящее время не поддерживаются (`YYYY-MM`, `YYYY`).3712. Расширенные представления дат в настоящее время не поддерживаются (`±YYYYYY-MM-DD`).3723. Порядковые даты в настоящее время не поддерживаются (`YYYY-OOO`).373374Примеры:375376```python377>>> from datetime import date378>>> date.fromisoformat('2019-12-04')379datetime.date(2019, 12, 4)380>>> date.fromisoformat('20191204')381datetime.date(2019, 12, 4)382>>> date.fromisoformat('2021-W01-1')383datetime.date(2021, 1, 4)384```385386Добавлено в версии 3.7.387388Изменено в версии 3.11: Ранее этот метод поддерживал только формат `YYYY-MM-DD`.389390#### `classmethod date.fromisocalendar(year, week, day)`391392Возвращает [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date), соответствующий дате по календарю ISO, заданной годом, неделей и днём. Это обратная функция для [`date.isocalendar()`](https://python-all.ru/3.12/library/datetime.html#datetime.date.isocalendar).393394Добавлено в версии 3.8.395396Атрибуты класса:397398#### `date.min`399400Самая ранняя представимая дата, `date(MINYEAR, 1, 1)`.401402#### `date.max`403404Самая поздняя представимая дата, `date(MAXYEAR, 12, 31)`.405406#### `date.resolution`407408Наименьшая возможная разница между неравными объектами дат, `timedelta(days=1)`.409410Атрибуты экземпляра (только для чтения):411412#### `date.year`413414От [`MINYEAR`](https://python-all.ru/3.12/library/datetime.html#datetime.MINYEAR) до [`MAXYEAR`](https://python-all.ru/3.12/library/datetime.html#datetime.MAXYEAR) включительно.415416#### `date.month`417418От 1 до 12 включительно.419420#### `date.day`421422От 1 до количества дней в указанном месяце указанного года.423424Поддерживаемые операции:425426| Операция | Результат |427| --- | --- |428| `date2 = date1 + timedelta` | `date2` будет на `timedelta.days` дней позже `date1`. (1) |429| `date2 = date1 - timedelta` | Вычисляет `date2` так, что `date2 + timedelta == date1`. (2) |430| `timedelta = date1 - date2` | (3) |431| `date1 == date2` `date1 != date2` | Сравнение на равенство. (4) |432| `date1 < date2` `date1 > date2` `date1 <= date2` `date1 >= date2` | Сравнение порядка. (5) |433434Примечания:4354361. *date2* сдвигается вперёд во времени, если `timedelta.days > 0`, или назад, если `timedelta.days < 0`. После этого `date2 - date1 == timedelta.days`. `timedelta.seconds` и `timedelta.microseconds` игнорируются. [`OverflowError`](https://python-all.ru/3.12/library/exceptions.html#OverflowError) возбуждается, если `date2.year` оказался бы меньше, чем [`MINYEAR`](https://python-all.ru/3.12/library/datetime.html#datetime.MINYEAR), или больше, чем [`MAXYEAR`](https://python-all.ru/3.12/library/datetime.html#datetime.MAXYEAR).4372. `timedelta.seconds` и `timedelta.microseconds` игнорируются.4383. Это точная операция и не может вызвать переполнение. `timedelta.seconds` и `timedelta.microseconds` равны 0, а `date2 + timedelta == date1` после.4394. Объекты [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date) равны, если они представляют одну и ту же дату.4405. *date1* считается меньше *date2*, когда *date1* предшествует *date2* во времени. Другими словами, `date1 < date2` тогда и только тогда, когда `date1.toordinal() < date2.toordinal()`.441442В булевом контексте все объекты [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date) считаются истинными.443444Методы экземпляра:445446#### `date.replace(year=self.year, month=self.month, day=self.day)`447448Возвращает новый объект [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date) с теми же значениями, но с обновлёнными указанными параметрами.449450Пример:451452```python453>>> from datetime import date454>>> d = date(2002, 12, 31)455>>> d.replace(day=26)456datetime.date(2002, 12, 26)457```458459#### `date.timetuple()`460461Возвращает [`time.struct_time`](https://python-all.ru/3.12/library/time.html#time.struct_time) такой, какой возвращается [`time.localtime()`](https://python-all.ru/3.12/library/time.html#time.localtime).462463Часы, минуты и секунды равны 0, а флаг DST равен -1.464465`d.timetuple()` эквивалентно:466467```python468time.struct_time((d.year, d.month, d.day, 0, 0, 0, d.weekday(), yday, -1))469```470471где `yday = d.toordinal() - date(d.year, 1, 1).toordinal() + 1` – это номер дня в текущем году, начиная с 1 для 1 января.472473#### `date.toordinal()`474475Возвращает пролептический григорианский порядковый номер даты, где 1 января 1 года имеет порядковый номер 1. Для любого объекта [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date) `d`, `date.fromordinal(d.toordinal()) == d`.476477#### `date.weekday()`478479Возвращает день недели в виде целого числа, где понедельник – 0, а воскресенье – 6. Например, `date(2002, 12, 4).weekday() == 2`, среда. См. также [`isoweekday()`](https://python-all.ru/3.12/library/datetime.html#datetime.date.isoweekday).480481#### `date.isoweekday()`482483Возвращает день недели в виде целого числа, где понедельник – 1, а воскресенье – 7. Например, `date(2002, 12, 4).isoweekday() == 3`, среда. См. также [`weekday()`](https://python-all.ru/3.12/library/datetime.html#datetime.date.weekday), [`isocalendar()`](https://python-all.ru/3.12/library/datetime.html#datetime.date.isocalendar).484485#### `date.isocalendar()`486487Возвращает объект [именованный кортеж](https://python-all.ru/3.12/glossary.html#term-named-tuple) с тремя компонентами: `year`, `week` и `weekday`.488489Календарь ISO – широко используемый вариант григорианского календаря. [\[3\]](https://python-all.ru/3.12/library/datetime.html#id6)490491Год ISO состоит из 52 или 53 полных недель, причём неделя начинается в понедельник и заканчивается в воскресенье. Первая неделя года ISO – это первая (григорианская) календарная неделя года, в которую входит четверг. Она называется неделей номер 1, и год ISO этого четверга совпадает с его григорианским годом.492493Например, 2004 год начинается в четверг, поэтому первая неделя года ISO 2004 начинается в понедельник, 29 декабря 2003 г., и заканчивается в воскресенье, 4 января 2004 г.:494495```python496>>> from datetime import date497>>> date(2003, 12, 29).isocalendar()498datetime.IsoCalendarDate(year=2004, week=1, weekday=1)499>>> date(2004, 1, 4).isocalendar()500datetime.IsoCalendarDate(year=2004, week=1, weekday=7)501```502503Изменено в версии 3.9: Результат изменён с кортежа на [именованный кортеж](https://python-all.ru/3.12/glossary.html#term-named-tuple).504505#### `date.isoformat()`506507Возвращает строку, представляющую дату в формате ISO 8601, `YYYY-MM-DD`:508509```python510>>> from datetime import date511>>> date(2002, 12, 4).isoformat()512'2002-12-04'513```514515#### `date.__str__()`516517Для даты `d` `str(d)` эквивалентно `d.isoformat()`.518519#### `date.ctime()`520521Возвращает строку, представляющую дату:522523```python524>>> from datetime import date525>>> date(2002, 12, 4).ctime()526'Wed Dec  4 00:00:00 2002'527```528529`d.ctime()` эквивалентно:530531```python532time.ctime(time.mktime(d.timetuple()))533```534535на платформах, где нативная функция C `ctime()` (которую вызывает [`time.ctime()`](https://python-all.ru/3.12/library/time.html#time.ctime), но которую [`date.ctime()`](https://python-all.ru/3.12/library/datetime.html#datetime.date.ctime) не вызывает) соответствует стандарту C.536537#### `date.strftime(format)`538539Возвращает строку с датой, форматированную по явной строке формата. Коды формата, соответствующие часам, минутам или секундам, будут принимать нулевые значения. См. также [strftime() and strptime() Behavior](https://python-all.ru/3.12/library/datetime.html#strftime-strptime-behavior) и [`date.isoformat()`](https://python-all.ru/3.12/library/datetime.html#datetime.date.isoformat).540541#### `date.__format__(format)`542543То же, что и [`date.strftime()`](https://python-all.ru/3.12/library/datetime.html#datetime.date.strftime). Это позволяет задать строку формата для объекта [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date) в [f-строках](https://python-all.ru/3.12/reference/lexical_analysis.html#f-strings) и при использовании [`str.format()`](https://python-all.ru/3.12/library/stdtypes.html#str.format). См. также [Поведение strftime() и strptime()](https://python-all.ru/3.12/library/datetime.html#strftime-strptime-behavior) и [`date.isoformat()`](https://python-all.ru/3.12/library/datetime.html#datetime.date.isoformat).544545### Примеры использования: [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date)546547Пример подсчёта дней до события:548549```python550>>> import time551>>> from datetime import date552>>> today = date.today()553>>> today554datetime.date(2007, 12, 5)555>>> today == date.fromtimestamp(time.time())556True557>>> my_birthday = date(today.year, 6, 24)558>>> if my_birthday < today:559...     my_birthday = my_birthday.replace(year=today.year + 1)560...561>>> my_birthday562datetime.date(2008, 6, 24)563>>> time_to_birthday = abs(my_birthday - today)564>>> time_to_birthday.days565202566```567568Другие примеры работы с [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date):569570```pycon571>>> from datetime import date572>>> d = date.fromordinal(730920) # 730920-й день после 1.1.0001573>>> d574datetime.date(2002, 3, 11)575576>>> # Методы, связанные с форматированием строкового вывода577>>> d.isoformat()578'2002-03-11'579>>> d.strftime("%d/%m/%y")580'11/03/02'581>>> d.strftime("%A %d. %B %Y")582'Monday 11. March 2002'583>>> d.ctime()584'Mon Mar 11 00:00:00 2002'585>>> 'The {1} is {0:%d}, the {2} is {0:%B}.'.format(d, "day", "month")586'The day is 11, the month is March.'587588>>> # Методы для извлечения 'компонентов' в разных календарях589>>> t = d.timetuple()590>>> for i in t:591...     print(i)5922002                # year5933                   # month59411                  # day5950596059705980                   # weekday (0 = Monday)59970                  # 70th day in the year600-1601>>> ic = d.isocalendar()602>>> for i in ic:603...     print(i)6042002                # ISO year60511                  # ISO week number6061                   # ISO day number ( 1 = Monday )607608>>> # Объект date является неизменяемым; все операции создают новый объект609>>> d.replace(year=2005)610datetime.date(2005, 3, 11)611```612613## [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) Объекты614615Объект [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) – это единый объект, содержащий всю информацию из объекта [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date) и объекта [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time).616617Как и объект [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date), [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) предполагает текущий григорианский календарь, расширенный в обе стороны; как и объект [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time), [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) предполагает, что в каждом дне ровно 3600\*24 секунд.618619Конструктор:620621#### `class datetime.datetime(year, month, day, hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)`622623Аргументы *year*, *month* и *day* обязательны. *tzinfo* может быть `None` или экземпляром подкласса [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo). Остальные аргументы должны быть целыми числами в следующих диапазонах:624625- `MINYEAR <= year <= MAXYEAR`,626- `1 <= month <= 12`,627- `1 <= day <= number of days in the given month and year`,628- `0 <= hour < 24`,629- `0 <= minute < 60`,630- `0 <= second < 60`,631- `0 <= microsecond < 1000000`,632- `fold in [0, 1]`.633634Если указан аргумент вне этих диапазонов, возбуждается [`ValueError`](https://python-all.ru/3.12/library/exceptions.html#ValueError).635636Изменено в версии 3.6: Добавлен параметр *fold*.637638Другие конструкторы – все методы класса:639640#### `classmethod datetime.today()`641642Возвращает текущие локальные дату и время, с [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo) `None`.643644Эквивалентно следующему:645646```python647datetime.fromtimestamp(time.time())648```649650См. также [`now()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.now), [`fromtimestamp()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.fromtimestamp).651652Этот метод функционально эквивалентен [`now()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.now), но без параметра `tz`.653654#### `classmethod datetime.now(tz=None)`655656Возвращает текущие локальные дату и время.657658Если необязательный аргумент *tz* равен `None` или не указан, это аналогично [`today()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.today), но, по возможности, обеспечивает большую точность, чем можно получить через метку времени [`time.time()`](https://python-all.ru/3.12/library/time.html#time.time) (например, это возможно на платформах, предоставляющих функцию C `gettimeofday()`).659660Если *tz* не равен `None`, он должен быть экземпляром подкласса [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo), а текущие дата и время преобразуются в часовой пояс *tz*.661662Эта функция предпочтительнее [`today()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.today) и [`utcnow()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.utcnow).663664> **Примечание**665>666> Последующие вызовы `datetime.now()` могут возвращать один и тот же момент времени в зависимости от точности базовых часов.667668#### `classmethod datetime.utcnow()`669670Возвращает текущие дату и время UTC, с [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo) `None`.671672Это похоже на [`now()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.now), но возвращает текущие дату и время UTC в виде наивного объекта [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime). Осведомлённый объект текущего времени UTC можно получить, вызвав `datetime.now(timezone.utc)`. См. также [`now()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.now).673674> **Предупреждение**675>676> Поскольку наивные объекты `datetime` многими методами `datetime` рассматриваются как местное время, для представления времени в UTC предпочтительнее использовать осведомлённые объекты datetime. Поэтому рекомендуемый способ создания объекта, представляющего текущее время в UTC, – вызов `datetime.now(timezone.utc)`.677678Устарело с версии 3.12: Вместо этого используйте [`datetime.now()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.now) с [`UTC`](https://python-all.ru/3.12/library/datetime.html#datetime.UTC).679680#### `classmethod datetime.fromtimestamp(timestamp, tz=None)`681682Возвращает локальные дату и время, соответствующие метке времени POSIX, такой как возвращается [`time.time()`](https://python-all.ru/3.12/library/time.html#time.time). Если необязательный аргумент *tz* равен `None` или не указан, метка времени преобразуется в локальные дату и время платформы, и возвращаемый объект [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) является наивным.683684Если *tz* не равен `None`, он должен быть экземпляром подкласса [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo), и метка времени преобразуется в часовой пояс *tz*.685686[`fromtimestamp()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.fromtimestamp) может возбуждать [`OverflowError`](https://python-all.ru/3.12/library/exceptions.html#OverflowError), если метка времени выходит за диапазон значений, поддерживаемых платформенными функциями C `localtime()` или `gmtime()`, и [`OSError`](https://python-all.ru/3.12/library/exceptions.html#OSError) при ошибке `localtime()` или `gmtime()`. Обычно это ограничено годами с 1970 по 2038. Обратите внимание, что на системах, не совместимых с POSIX, которые включают високосные секунды в своё представление метки времени, високосные секунды игнорируются [`fromtimestamp()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.fromtimestamp), и поэтому возможно иметь две метки времени, различающиеся на секунду, которые дают идентичные объекты [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime). Этот метод предпочтительнее [`utcfromtimestamp()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.utcfromtimestamp).687688Изменено в версии 3.3: Возбуждает [`OverflowError`](https://python-all.ru/3.12/library/exceptions.html#OverflowError) вместо [`ValueError`](https://python-all.ru/3.12/library/exceptions.html#ValueError), если метка времени выходит за диапазон значений, поддерживаемых платформенными функциями C `localtime()` или `gmtime()`. Возбуждает [`OSError`](https://python-all.ru/3.12/library/exceptions.html#OSError) вместо [`ValueError`](https://python-all.ru/3.12/library/exceptions.html#ValueError) при ошибке `localtime()` или `gmtime()`.689690Изменено в версии 3.6: [`fromtimestamp()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.fromtimestamp) может возвращать экземпляры с [`fold`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.fold), установленным в 1.691692#### `classmethod datetime.utcfromtimestamp(timestamp)`693694Возвращает [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) UTC, соответствующий метке времени POSIX, с [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo) `None`. (Результирующий объект является наивным.)695696Это может возбуждать [`OverflowError`](https://python-all.ru/3.12/library/exceptions.html#OverflowError), если метка времени выходит за диапазон значений, поддерживаемых платформенной функцией C `gmtime()`, и [`OSError`](https://python-all.ru/3.12/library/exceptions.html#OSError) при ошибке `gmtime()`. Обычно это ограничено годами с 1970 по 2038.697698Чтобы получить осведомлённый объект [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime), вызовите [`fromtimestamp()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.fromtimestamp):699700```python701datetime.fromtimestamp(timestamp, timezone.utc)702```703704На платформах, совместимых с POSIX, это эквивалентно следующему выражению:705706```python707datetime(1970, 1, 1, tzinfo=timezone.utc) + timedelta(seconds=timestamp)708```709710за исключением того, что последняя формула всегда поддерживает полный диапазон лет: от [`MINYEAR`](https://python-all.ru/3.12/library/datetime.html#datetime.MINYEAR) до [`MAXYEAR`](https://python-all.ru/3.12/library/datetime.html#datetime.MAXYEAR) включительно.711712> **Предупреждение**713>714> Поскольку наивные объекты `datetime` во многих методах `datetime` трактуются как местное время, для представления времени в UTC предпочтительнее использовать aware-даты. Поэтому рекомендуемый способ создания объекта для конкретной метки времени в UTC – вызов `datetime.fromtimestamp(timestamp, tz=timezone.utc)`.715716Изменено в версии 3.3: Вызывает [`OverflowError`](https://python-all.ru/3.12/library/exceptions.html#OverflowError) вместо [`ValueError`](https://python-all.ru/3.12/library/exceptions.html#ValueError), если метка времени выходит за пределы диапазона значений, поддерживаемого функцией `gmtime()` платформы C. Вызывает [`OSError`](https://python-all.ru/3.12/library/exceptions.html#OSError) вместо [`ValueError`](https://python-all.ru/3.12/library/exceptions.html#ValueError) при ошибке `gmtime()`.717718Устарело с версии 3.12: Вместо этого используйте [`datetime.fromtimestamp()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.fromtimestamp) с [`UTC`](https://python-all.ru/3.12/library/datetime.html#datetime.UTC).719720#### `classmethod datetime.fromordinal(ordinal)`721722Возвращает [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime), соответствующий пролептическому григорианскому порядковому номеру, где 1 января 1 года имеет порядковый номер 1. [`ValueError`](https://python-all.ru/3.12/library/exceptions.html#ValueError) вызывается, если не выполнено `1 <= ordinal <= datetime.max.toordinal()`. Час, минута, секунда и микросекунда результата равны 0, а [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo) равен `None`.723724#### `classmethod datetime.combine(date, time, tzinfo=time.tzinfo)`725726Возвращает новый объект [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime), компоненты даты которого равны компонентам заданного объекта [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date), а компоненты времени равны компонентам заданного объекта [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time). Если указан аргумент *tzinfo*, его значение используется для установки атрибута [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo) результата, в противном случае используется атрибут [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.time.tzinfo) аргумента *time*. Если аргумент *date* является объектом [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime), его компоненты времени и атрибуты [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo) игнорируются.727728Для любого объекта [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) `d`, `d == datetime.combine(d.date(), d.time(), d.tzinfo)`.729730Изменено в версии 3.6: Добавлен аргумент *tzinfo*.731732#### `classmethod datetime.fromisoformat(date_string)`733734Возвращает [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime), соответствующий строке *date\_string* в любом допустимом формате ISO 8601, за следующими исключениями:7357361. Смещения часовых поясов могут содержать доли секунды.7372. Разделитель `T` может быть заменён любым отдельным символом Unicode.7383. Доли часов и минут не поддерживаются.7394. Даты с пониженной точностью в настоящее время не поддерживаются (`YYYY-MM`, `YYYY`).7405. Расширенные представления дат в настоящее время не поддерживаются (`±YYYYYY-MM-DD`).7416. Порядковые даты в настоящее время не поддерживаются (`YYYY-OOO`).742743Примеры:744745```python746>>> from datetime import datetime747>>> datetime.fromisoformat('2011-11-04')748datetime.datetime(2011, 11, 4, 0, 0)749>>> datetime.fromisoformat('20111104')750datetime.datetime(2011, 11, 4, 0, 0)751>>> datetime.fromisoformat('2011-11-04T00:05:23')752datetime.datetime(2011, 11, 4, 0, 5, 23)753>>> datetime.fromisoformat('2011-11-04T00:05:23Z')754datetime.datetime(2011, 11, 4, 0, 5, 23, tzinfo=datetime.timezone.utc)755>>> datetime.fromisoformat('20111104T000523')756datetime.datetime(2011, 11, 4, 0, 5, 23)757>>> datetime.fromisoformat('2011-W01-2T00:05:23.283')758datetime.datetime(2011, 1, 4, 0, 5, 23, 283000)759>>> datetime.fromisoformat('2011-11-04 00:05:23.283')760datetime.datetime(2011, 11, 4, 0, 5, 23, 283000)761>>> datetime.fromisoformat('2011-11-04 00:05:23.283+00:00')762datetime.datetime(2011, 11, 4, 0, 5, 23, 283000, tzinfo=datetime.timezone.utc)763>>> datetime.fromisoformat('2011-11-04T00:05:23+04:00')764datetime.datetime(2011, 11, 4, 0, 5, 23,765    tzinfo=datetime.timezone(datetime.timedelta(seconds=14400)))766```767768Добавлено в версии 3.7.769770Изменено в версии 3.11: Ранее этот метод поддерживал только форматы, которые могли быть созданы с помощью [`date.isoformat()`](https://python-all.ru/3.12/library/datetime.html#datetime.date.isoformat) или [`datetime.isoformat()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.isoformat).771772#### `classmethod datetime.fromisocalendar(year, week, day)`773774Возвращает [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime), соответствующий дате по ISO-календарю, заданной годом, неделей и днём. Компоненты datetime, не относящиеся к дате, заполняются обычными значениями по умолчанию. Это обратная функция для [`datetime.isocalendar()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.isocalendar).775776Добавлено в версии 3.8.777778#### `classmethod datetime.strptime(date_string, format)`779780Возвращает объект [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime), соответствующий *date\_string*, разобранный в соответствии с *format*.781782Если *format* не содержит микросекунд или информации о часовом поясе, это эквивалентно:783784```python785datetime(*(time.strptime(date_string, format)[0:6]))786```787788[`ValueError`](https://python-all.ru/3.12/library/exceptions.html#ValueError) возбуждается, если date\_string и format не удаётся разобрать с помощью [`time.strptime()`](https://python-all.ru/3.12/library/time.html#time.strptime), или если возвращается значение, не являющееся кортежем времени. См. также [strftime() and strptime() Behavior](https://python-all.ru/3.12/library/datetime.html#strftime-strptime-behavior) и [`datetime.fromisoformat()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.fromisoformat).789790Атрибуты класса:791792#### `datetime.min`793794Самое раннее представимое [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime), `datetime(MINYEAR, 1, 1, tzinfo=None)`.795796#### `datetime.max`797798Самое позднее представимое [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime), `datetime(MAXYEAR, 12, 31, 23, 59, 59, 999999, tzinfo=None)`.799800#### `datetime.resolution`801802Наименьшая возможная разница между неравными [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) объектами, `timedelta(microseconds=1)`.803804Атрибуты экземпляра (только для чтения):805806#### `datetime.year`807808От [`MINYEAR`](https://python-all.ru/3.12/library/datetime.html#datetime.MINYEAR) до [`MAXYEAR`](https://python-all.ru/3.12/library/datetime.html#datetime.MAXYEAR) включительно.809810#### `datetime.month`811812От 1 до 12 включительно.813814#### `datetime.day`815816От 1 до количества дней в указанном месяце указанного года.817818#### `datetime.hour`819820В `range(24)`.821822#### `datetime.minute`823824В `range(60)`.825826#### `datetime.second`827828В `range(60)`.829830#### `datetime.microsecond`831832В `range(1000000)`.833834#### `datetime.tzinfo`835836Объект, переданный в качестве аргумента *tzinfo* конструктору [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime), или `None`, если ничего не было передано.837838#### `datetime.fold`839840В `[0, 1]`. Используется для устранения неоднозначности поясного времени в повторяющемся интервале. (Повторяющийся интервал возникает, когда часы переводятся назад в конце перехода на летнее время или когда смещение UTC для текущего часового пояса уменьшается по политическим причинам.) Значения 0 и 1 представляют соответственно более ранний и более поздний из двух моментов с одинаковым представлением поясного времени.841842Добавлено в версии 3.6.843844Поддерживаемые операции:845846| Операция | Результат |847| --- | --- |848| `datetime2 = datetime1 + timedelta` | (1) |849| `datetime2 = datetime1 - timedelta` | (2) |850| `timedelta = datetime1 - datetime2` | (3) |851| `datetime1 == datetime2` `datetime1 != datetime2` | Сравнение на равенство. (4) |852| `datetime1 < datetime2` `datetime1 > datetime2` `datetime1 <= datetime2` `datetime1 >= datetime2` | Сравнение порядка. (5) |8538541. `datetime2` – это длительность `timedelta`, вычитаемая из `datetime1`, сдвигающая время вперёд, если `timedelta.days > 0`, или назад, если `timedelta.days < 0`. Результат имеет тот же атрибут [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo), что и исходный datetime, и `datetime2 - datetime1 == timedelta` после. [`OverflowError`](https://python-all.ru/3.12/library/exceptions.html#OverflowError) возникает, если `datetime2.year` окажется меньше [`MINYEAR`](https://python-all.ru/3.12/library/datetime.html#datetime.MINYEAR) или больше [`MAXYEAR`](https://python-all.ru/3.12/library/datetime.html#datetime.MAXYEAR). Обратите внимание, что корректировка часового пояса не выполняется, даже если исходный объект осведомлён.8552. Вычисляет `datetime2`, такой что `datetime2 + timedelta == datetime1`. Как и при сложении, результат имеет тот же атрибут [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo), что и исходный datetime, и корректировка часового пояса не выполняется, даже если исходный объект осведомлён.8563. Вычитание [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) из [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) определено только если оба операнда наивны или оба осведомлены. Если один осведомлён, а другой наивен, возникает [`TypeError`](https://python-all.ru/3.12/library/exceptions.html#TypeError).857858   Если оба наивны, или оба осведомлены и имеют одинаковый атрибут [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo), атрибуты [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo) игнорируются, и результатом является объект [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) `t`, такой что `datetime2 + t == datetime1`. В этом случае корректировка часового пояса не выполняется.859860   Если оба осведомлены и имеют разные атрибуты [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo), `a-b` действует так, как если бы `a` и `b` были сначала преобразованы в наивные объекты datetime в UTC. Результат – `(a.replace(tzinfo=None) - a.utcoffset()) - (b.replace(tzinfo=None) - b.utcoffset())`, за исключением того, что в реализации никогда не возникает переполнения.8614. Объекты [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) равны, если они представляют одну и ту же дату и время с учётом часового пояса.862863   Наивные и осведомлённые объекты `datetime` никогда не равны. Объекты `datetime` никогда не равны объектам [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date), не являющимся также экземплярами `datetime`, даже если они представляют одну и ту же дату.864865   Если оба операнда осознающие и имеют одинаковый атрибут `tzinfo`, атрибуты `tzinfo` и [`fold`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.fold) игнорируются, и сравниваются базовые даты и время. Если оба операнда осознающие и имеют разные атрибуты [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo), сравнение ведётся так, как если бы операнды сначала были преобразованы в даты и время в UTC, за исключением того, что реализация никогда не вызывает переполнение. Экземпляры `datetime` в повторяющемся интервале никогда не равны экземплярам `datetime` в другом часовом поясе.8665. *datetime1* считается меньше *datetime2*, когда *datetime1* предшествует *datetime2* во времени с учётом часового пояса.867868   Сравнение порядка между наивными и осведомлёнными объектами [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime), а также между объектом `datetime` и объектом `date`, не являющимся также экземпляром `datetime`, вызывает [`TypeError`](https://python-all.ru/3.12/library/exceptions.html#TypeError).869870   Если оба операнда осознающие и имеют одинаковый атрибут `tzinfo`, атрибуты `tzinfo` и [`fold`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.fold) игнорируются, и сравниваются базовые даты и время. Если оба операнда осознающие и имеют разные атрибуты [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo), сравнение ведётся так, как если бы операнды сначала были преобразованы в даты и время в UTC, за исключением того, что реализация никогда не вызывает переполнение.871872Изменено в версии 3.3: Сравнения на равенство между осознающими и наивными экземплярами [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) не вызывают [`TypeError`](https://python-all.ru/3.12/library/exceptions.html#TypeError).873874Методы экземпляра:875876#### `datetime.date()`877878Возвращает объект [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date) с тем же годом, месяцем и днём.879880#### `datetime.time()`881882Возвращает объект [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) с теми же часами, минутами, секундами, микросекундами и fold. [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo) равно `None`. См. также метод [`timetz()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.timetz).883884Изменено в версии 3.6: Значение fold копируется в возвращаемый объект [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time).885886#### `datetime.timetz()`887888Возвращает объект [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) с теми же атрибутами hour, minute, second, microsecond, fold и tzinfo. См. также метод [`time()`](https://python-all.ru/3.12/library/time.html#module-time).889890Изменено в версии 3.6: Значение fold копируется в возвращаемый объект [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time).891892#### `datetime.replace(year=self.year, month=self.month, day=self.day, hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond, tzinfo=self.tzinfo, *, fold=0)`893894Возвращает новый объект [`datetime`](https://python-all.ru/3.12/library/datetime.html#module-datetime) с теми же атрибутами, но с обновлёнными указанными параметрами. Обратите внимание, что `tzinfo=None` можно указать, чтобы создать наивный datetime из осознающего без преобразования данных даты и времени.895896Изменено в версии 3.6: Добавлен параметр *fold*.897898#### `datetime.astimezone(tz=None)`899900Возвращает объект [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) с новым атрибутом [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo) *tz*, корректируя данные даты и времени так, чтобы результат соответствовал тому же времени UTC, что и *self*, но в местном времени *tz*.901902Если *tz* указан, он должен быть экземпляром подкласса [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo), а его методы [`utcoffset()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.utcoffset) и [`dst()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.dst) не должны возвращать `None`. Если *self* наивный, предполагается, что он представляет время в системном часовом поясе.903904Если вызывается без аргументов (или с `tz=None`), для целевого часового пояса используется системный местный часовой пояс. Атрибут `.tzinfo` преобразованного экземпляра datetime будет установлен в экземпляр [`timezone`](https://python-all.ru/3.12/library/datetime.html#datetime.timezone) с именем зоны и смещением, полученными от ОС.905906Если `self.tzinfo` равно *tz*, `self.astimezone(tz)` равно *self*: корректировка данных даты или времени не выполняется. В противном случае результат – местное время в часовом поясе *tz*, представляющее то же время UTC, что и *self*: после `astz = dt.astimezone(tz)` `astz - astz.utcoffset()` будут содержать те же данные даты и времени, что и `dt - dt.utcoffset()`.907908Если нужно просто прикрепить объект [`timezone`](https://python-all.ru/3.12/library/datetime.html#datetime.timezone) *tz* к datetime *dt* без корректировки данных даты и времени, используйте `dt.replace(tzinfo=tz)`. Если нужно просто удалить объект `timezone` из осознающего datetime *dt* без преобразования данных даты и времени, используйте `dt.replace(tzinfo=None)`.909910Обратите внимание, что метод по умолчанию [`tzinfo.fromutc()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.fromutc) можно переопределить в подклассе [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo), чтобы повлиять на результат, возвращаемый [`astimezone()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.astimezone). Если не учитывать ошибки, [`astimezone()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.astimezone) работает следующим образом:911912```python913def astimezone(self, tz):914    if self.tzinfo is tz:915        return self916    # Преобразует self в UTC и присоединяет новый объект часового пояса.917    utc = (self - self.utcoffset()).replace(tzinfo=tz)918    # Преобразует из UTC в местное время tz.919    return tz.fromutc(utc)920```921922Изменено в версии 3.3: *tz* теперь можно опускать.923924Изменено в версии 3.6: Метод [`astimezone()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.astimezone) теперь можно вызывать для наивных экземпляров, которые считаются представляющими системное местное время.925926#### `datetime.utcoffset()`927928Если [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo) равно `None`, возвращает `None`, иначе возвращает `self.tzinfo.utcoffset(self)`, и возбуждает исключение, если последнее не возвращает `None` или объект [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) с величиной менее одного дня.929930Изменено в версии 3.7: Смещение UTC теперь не ограничено целым числом минут.931932#### `datetime.dst()`933934Если [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo) равно `None`, возвращается `None`, иначе возвращается `self.tzinfo.dst(self)`, и возбуждается исключение, если последний не возвращает `None` или объект [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) с величиной меньше одного дня.935936Изменено в версии 3.7: Смещение DST не ограничивается целым числом минут.937938#### `datetime.tzname()`939940Если [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo) равно `None`, возвращается `None`, иначе возвращается `self.tzinfo.tzname(self)`, возбуждается исключение, если последний не возвращает `None` или строковый объект,941942#### `datetime.timetuple()`943944Возвращает [`time.struct_time`](https://python-all.ru/3.12/library/time.html#time.struct_time) такой, какой возвращается [`time.localtime()`](https://python-all.ru/3.12/library/time.html#time.localtime).945946`d.timetuple()` эквивалентно:947948```python949time.struct_time((d.year, d.month, d.day,950                  d.hour, d.minute, d.second,951                  d.weekday(), yday, dst))952```953954где `yday = d.toordinal() - date(d.year, 1, 1).toordinal() + 1` – номер дня в текущем году, начиная с 1 для 1 января. Флаг [`tm_isdst`](https://python-all.ru/3.12/library/time.html#time.struct_time.tm_isdst) результата устанавливается в соответствии с методом [`dst()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.dst): если [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo) равно `None` или [`dst()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.dst) возвращает `None`, `tm_isdst` устанавливается в `-1`; иначе, если [`dst()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.dst) возвращает ненулевое значение, `tm_isdst` устанавливается в 1; иначе `tm_isdst` устанавливается в 0.955956#### `datetime.utctimetuple()`957958Если экземпляр [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) `d` наивный, это то же самое, что `d.timetuple()`, за исключением того, что [`tm_isdst`](https://python-all.ru/3.12/library/time.html#time.struct_time.tm_isdst) принудительно устанавливается в 0 независимо от того, что возвращает `d.dst()`. DST никогда не действует для времени UTC.959960Если `d` осознанный, `d` нормализуется к времени UTC вычитанием `d.utcoffset()`, и возвращается [`time.struct_time`](https://python-all.ru/3.12/library/time.html#time.struct_time) для нормализованного времени. `tm_isdst` принудительно устанавливается в 0. Обратите внимание, что может быть возбуждено [`OverflowError`](https://python-all.ru/3.12/library/exceptions.html#OverflowError), если `d.year` было `MINYEAR` или `MAXYEAR` и корректировка UTC выходит за границу года.961962> **Предупреждение**963>964> Поскольку наивные объекты `datetime` рассматриваются многими методами `datetime` как местное время, предпочтительнее использовать осознанные объекты datetime для представления времени в UTC; как результат, использование [`datetime.utctimetuple()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.utctimetuple) может давать вводящие в заблуждение результаты. Если у вас есть наивный `datetime`, представляющий UTC, используйте `datetime.replace(tzinfo=timezone.utc)`, чтобы сделать его осознанным, после чего можно использовать [`datetime.timetuple()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.timetuple).965966#### `datetime.toordinal()`967968Возвращает пролептический григорианский порядковый номер даты. То же, что `self.date().toordinal()`.969970#### `datetime.timestamp()`971972Возвращает временную метку POSIX, соответствующую экземпляру [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime). Возвращаемое значение – [`float`](https://python-all.ru/3.12/library/functions.html#float), похожее на то, что возвращается [`time.time()`](https://python-all.ru/3.12/library/time.html#time.time).973974Наивные экземпляры [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) считаются представляющими местное время, и этот метод полагается на функцию C `mktime()` платформы для выполнения преобразования. Поскольку [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) поддерживает более широкий диапазон значений, чем `mktime()` на многих платформах, этот метод может возбуждать [`OverflowError`](https://python-all.ru/3.12/library/exceptions.html#OverflowError) или [`OSError`](https://python-all.ru/3.12/library/exceptions.html#OSError) для моментов времени в далёком прошлом или далёком будущем.975976Для осознанных экземпляров [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) возвращаемое значение вычисляется как:977978```python979(dt - datetime(1970, 1, 1, tzinfo=timezone.utc)).total_seconds()980```981982Добавлено в версии 3.3.983984Изменено в версии 3.6: Метод [`timestamp()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.timestamp) использует атрибут [`fold`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.fold) для устранения неоднозначности моментов времени в течение повторяющегося интервала.985986> **Примечание**987>988> Нет метода для получения временной метки POSIX непосредственно из наивного экземпляра [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime), представляющего время UTC. Если ваше приложение использует это соглашение и часовой пояс вашей системы не установлен на UTC, вы можете получить временную метку POSIX, указав `tzinfo=timezone.utc`:989>990> ```python991> timestamp = dt.replace(tzinfo=timezone.utc).timestamp()992> ```993>994> или вычислив метку напрямую:995>996> ```python997> timestamp = (dt - datetime(1970, 1, 1)) / timedelta(seconds=1)998> ```9991000#### `datetime.weekday()`10011002Возвращает день недели в виде целого числа, где понедельник – 0, а воскресенье – 6. То же, что `self.date().weekday()`. См. также [`isoweekday()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.isoweekday).10031004#### `datetime.isoweekday()`10051006Возвращает день недели в виде целого числа, где понедельник – 1, а воскресенье – 7. То же, что `self.date().isoweekday()`. См. также [`weekday()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.weekday), [`isocalendar()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.isocalendar).10071008#### `datetime.isocalendar()`10091010Возвращает [именованный кортеж](https://python-all.ru/3.12/glossary.html#term-named-tuple) с тремя компонентами: `year`, `week` и `weekday`. То же, что `self.date().isocalendar()`.10111012#### `datetime.isoformat(sep='T', timespec='auto')`10131014Возвращает строку, представляющую дату и время в формате ISO 8601:10151016- `YYYY-MM-DDTHH:MM:SS.ffffff`, если [`microsecond`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.microsecond) не равно 01017- `YYYY-MM-DDTHH:MM:SS`, если [`microsecond`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.microsecond) равно 010181019Если [`utcoffset()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.utcoffset) не возвращает `None`, добавляется строка с указанием смещения UTC:10201021- `YYYY-MM-DDTHH:MM:SS.ffffff+HH:MM[:SS[.ffffff]]`, если [`microsecond`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.microsecond) не равно 01022- `YYYY-MM-DDTHH:MM:SS+HH:MM[:SS[.ffffff]]`, если [`microsecond`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.microsecond) равно 010231024Примеры:10251026```python1027>>> from datetime import datetime, timezone1028>>> datetime(2019, 5, 18, 15, 17, 8, 132263).isoformat()1029'2019-05-18T15:17:08.132263'1030>>> datetime(2019, 5, 18, 15, 17, tzinfo=timezone.utc).isoformat()1031'2019-05-18T15:17:00+00:00'1032```10331034Необязательный аргумент *sep* (по умолчанию `'T'`) – это односимвольный разделитель, который ставится между частями даты и времени результата. Например:10351036```python1037>>> from datetime import tzinfo, timedelta, datetime1038>>> class TZ(tzinfo):1039...     """Часовой пояс с произвольным постоянным смещением -06:39."""1040...     def utcoffset(self, dt):1041...         return timedelta(hours=-6, minutes=-39)1042...1043>>> datetime(2002, 12, 25, tzinfo=TZ()).isoformat(' ')1044'2002-12-25 00:00:00-06:39'1045>>> datetime(2009, 11, 27, microsecond=100, tzinfo=TZ()).isoformat()1046'2009-11-27T00:00:00.000100-06:39'1047```10481049Необязательный аргумент *timespec* указывает количество дополнительных компонентов времени, которые нужно включить (по умолчанию `'auto'`). Он может быть одним из следующих:10501051- `'auto'`: То же, что и `'seconds'`, если [`microsecond`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.microsecond) равно 0, иначе то же, что и `'microseconds'`.1052- `'hours'`: Включает [`hour`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.hour) в двухзначном формате `HH`.1053- `'minutes'`: Включает [`hour`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.hour) и [`minute`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.minute) в формате `HH:MM`.1054- `'seconds'`: Включает [`hour`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.hour), [`minute`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.minute) и [`second`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.second) в формате `HH:MM:SS`.1055- `'milliseconds'`: Включает полное время, но усекает дробную часть секунд до миллисекунд. Формат `HH:MM:SS.sss`.1056- `'microseconds'`: Включает полное время в формате `HH:MM:SS.ffffff`.10571058> **Примечание**1059>1060> Исключённые компоненты времени усекаются, а не округляются.10611062[`ValueError`](https://python-all.ru/3.12/library/exceptions.html#ValueError) будет возбуждено при недопустимом значении аргумента *timespec*:10631064```python1065>>> from datetime import datetime1066>>> datetime.now().isoformat(timespec='minutes')1067'2002-12-25T00:00'1068>>> dt = datetime(2015, 1, 1, 12, 30, 59, 0)1069>>> dt.isoformat(timespec='microseconds')1070'2015-01-01T12:30:59.000000'1071```10721073Изменено в версии 3.6: Добавлен параметр *timespec*.10741075#### `datetime.__str__()`10761077Для экземпляра [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) `d` `str(d)` эквивалентно `d.isoformat(' ')`.10781079#### `datetime.ctime()`10801081Возвращает строку, представляющую дату и время:10821083```python1084>>> from datetime import datetime1085>>> datetime(2002, 12, 4, 20, 30, 40).ctime()1086'Wed Dec  4 20:30:40 2002'1087```10881089Результирующая строка *не* содержит информацию о часовом поясе независимо от того, является ли исходный объект aware или naive.10901091`d.ctime()` эквивалентно:10921093```python1094time.ctime(time.mktime(d.timetuple()))1095```10961097на платформах, где нативная C-функция `ctime()` (которая вызывается в [`time.ctime()`](https://python-all.ru/3.12/library/time.html#time.ctime), но не вызывается в [`datetime.ctime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.ctime)) соответствует стандарту C.10981099#### `datetime.strftime(format)`11001101Возвращает строку, представляющую дату и время, управляемую явной строкой формата. См. также [Поведение strftime() и strptime()](https://python-all.ru/3.12/library/datetime.html#strftime-strptime-behavior) и [`datetime.isoformat()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.isoformat).11021103#### `datetime.__format__(format)`11041105То же, что и [`datetime.strftime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strftime). Это позволяет задать строку формата для объекта [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) в [f-строках](https://python-all.ru/3.12/reference/lexical_analysis.html#f-strings) и при использовании [`str.format()`](https://python-all.ru/3.12/library/stdtypes.html#str.format). См. также [Поведение strftime() и strptime()](https://python-all.ru/3.12/library/datetime.html#strftime-strptime-behavior) и [`datetime.isoformat()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.isoformat).11061107### Примеры использования: [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime)11081109Примеры работы с объектами [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime):11101111```pycon1112>>> from datetime import datetime, date, time, timezone11131114>>> # Использование datetime.combine()1115>>> d = date(2005, 7, 14)1116>>> t = time(12, 30)1117>>> datetime.combine(d, t)1118datetime.datetime(2005, 7, 14, 12, 30)11191120>>> # Использование datetime.now()1121>>> datetime.now()1122datetime.datetime(2007, 12, 6, 16, 29, 43, 79043)   # GMT +11123>>> datetime.now(timezone.utc)1124datetime.datetime(2007, 12, 6, 15, 29, 43, 79060, tzinfo=datetime.timezone.utc)11251126>>> # Использование datetime.strptime()1127>>> dt = datetime.strptime("21/11/06 16:30", "%d/%m/%y %H:%M")1128>>> dt1129datetime.datetime(2006, 11, 21, 16, 30)11301131>>> # Использование datetime.timetuple() для получения кортежа всех атрибутов1132>>> tt = dt.timetuple()1133>>> for it in tt:1134...     print(it)1135...11362006    # year113711      # month113821      # day113916      # hour114030      # minute11410       # second11421       # weekday (0 = Monday)1143325     # number of days since 1st January1144-1      # dst - method tzinfo.dst() returned None11451146>>> # Дата в формате ISO1147>>> ic = dt.isocalendar()1148>>> for it in ic:1149...     print(it)1150...11512006    # ISO year115247      # ISO week11532       # ISO weekday11541155>>> # Форматирование datetime1156>>> dt.strftime("%A, %d. %B %Y %I:%M%p")1157'Tuesday, 21. November 2006 04:30PM'1158>>> 'The {1} is {0:%d}, the {2} is {0:%B}, the {3} is {0:%I:%M%p}.'.format(dt, "day", "month", "time")1159'The day is 21, the month is November, the time is 04:30PM.'1160```11611162В приведённом ниже примере определяется подкласс [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo), который фиксирует информацию о часовом поясе для Кабула (Афганистан). До 1945 года там использовалось смещение +4 UTC, а затем +4:30 UTC:11631164```python1165from datetime import timedelta, datetime, tzinfo, timezone11661167class KabulTz(tzinfo):1168    # В Кабуле до 1945 года использовали +4, затем перешли на +4:301169    UTC_MOVE_DATE = datetime(1944, 12, 31, 20, tzinfo=timezone.utc)11701171    def utcoffset(self, dt):1172        if dt.year < 1945:1173            return timedelta(hours=4)1174        elif (1945, 1, 1, 0, 0) <= dt.timetuple()[:5] < (1945, 1, 1, 0, 30):1175            # Неоднозначный («мнимый») получасовой диапазон, представляющий1176            # «складку» во времени из-за перехода с +4 на +4:30.1177            # Если dt попадает в мнимый диапазон, используйте fold для определения способа1178            # разрешения. См. PEP495.1179            return timedelta(hours=4, minutes=(30 if dt.fold else 0))1180        else:1181            return timedelta(hours=4, minutes=30)11821183    def fromutc(self, dt):1184        # Следуйте тем же проверкам, что и в datetime.tzinfo1185        if not isinstance(dt, datetime):1186            raise TypeError("fromutc() requires a datetime argument")1187        if dt.tzinfo is not self:1188            raise ValueError("dt.tzinfo is not self")11891190        # Для fromutc требуется собственная реализация, так как1191        # входные данные для этой функции – это datetime со значениями UTC1192        # но с tzinfo, установленным на self.1193        # См. datetime.astimezone или fromtimestamp.1194        if dt.replace(tzinfo=timezone.utc) >= self.UTC_MOVE_DATE:1195            return dt + timedelta(hours=4, minutes=30)1196        else:1197            return dt + timedelta(hours=4)11981199    def dst(self, dt):1200        # В Кабуле не соблюдается летнее время.1201        return timedelta(0)12021203    def tzname(self, dt):1204        if dt >= self.UTC_MOVE_DATE:1205            return "+04:30"1206        return "+04"1207```12081209Использование `KabulTz` из примера выше:12101211```python1212>>> tz1 = KabulTz()12131214>>> # Datetime до изменения1215>>> dt1 = datetime(1900, 11, 21, 16, 30, tzinfo=tz1)1216>>> print(dt1.utcoffset())12174:00:0012181219>>> # Datetime после изменения1220>>> dt2 = datetime(2006, 6, 14, 13, 0, tzinfo=tz1)1221>>> print(dt2.utcoffset())12224:30:0012231224>>> # Преобразовать datetime в другой часовой пояс1225>>> dt3 = dt2.astimezone(timezone.utc)1226>>> dt31227datetime.datetime(2006, 6, 14, 8, 30, tzinfo=datetime.timezone.utc)1228>>> dt21229datetime.datetime(2006, 6, 14, 13, 0, tzinfo=KabulTz())1230>>> dt2 == dt31231True1232```12331234## [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) Объекты12351236Объект [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) представляет (локальное) время суток, не привязанное к определённому дню и может корректироваться с помощью объекта [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo).12371238#### `class datetime.time(hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)`12391240Все аргументы необязательны. *tzinfo* может быть `None` или экземпляром подкласса [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo). Остальные аргументы должны быть целыми числами в следующих диапазонах:12411242- `0 <= hour < 24`,1243- `0 <= minute < 60`,1244- `0 <= second < 60`,1245- `0 <= microsecond < 1000000`,1246- `fold in [0, 1]`.12471248Если указан аргумент вне этих диапазонов, возбуждается [`ValueError`](https://python-all.ru/3.12/library/exceptions.html#ValueError). Все по умолчанию равны 0, кроме *tzinfo*, который по умолчанию равен `None`.12491250Атрибуты класса:12511252#### `time.min`12531254Самое раннее представимое [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time), `time(0, 0, 0, 0)`.12551256#### `time.max`12571258Самое позднее представимое [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time), `time(23, 59, 59, 999999)`.12591260#### `time.resolution`12611262Наименьшая возможная разница между неравными объектами [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time), `timedelta(microseconds=1)`, хотя следует отметить, что арифметические операции над объектами [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) не поддерживаются.12631264Атрибуты экземпляра (только для чтения):12651266#### `time.hour`12671268В `range(24)`.12691270#### `time.minute`12711272В `range(60)`.12731274#### `time.second`12751276В `range(60)`.12771278#### `time.microsecond`12791280В `range(1000000)`.12811282#### `time.tzinfo`12831284Объект, переданный как аргумент tzinfo конструктору [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time), или `None`, если ничего не было передано.12851286#### `time.fold`12871288В `[0, 1]`. Используется для устранения неоднозначности поясного времени в повторяющемся интервале. (Повторяющийся интервал возникает, когда часы переводятся назад в конце перехода на летнее время или когда смещение UTC для текущего часового пояса уменьшается по политическим причинам.) Значения 0 и 1 представляют соответственно более ранний и более поздний из двух моментов с одинаковым представлением поясного времени.12891290Добавлено в версии 3.6.12911292Объекты [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) поддерживают сравнение на равенство и порядок, где `a` считается меньше `b`, если `a` предшествует `b` во времени.12931294Наивные и осведомлённые объекты `time` никогда не равны. Сравнение по порядку между наивными и осведомлёнными объектами `time` вызывает [`TypeError`](https://python-all.ru/3.12/library/exceptions.html#TypeError).12951296Если оба сравниваемых объекта осведомлённые и имеют одинаковый атрибут [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.time.tzinfo), атрибуты `tzinfo` и `fold` игнорируются, и сравниваются базовые времена. Если оба сравниваемых объекта осведомлённые и имеют разные атрибуты `tzinfo`, сравниваемые объекты сначала корректируются путём вычитания их смещений UTC (полученных из `self.utcoffset()`).12971298Изменено в версии 3.3: Сравнения на равенство между осведомлёнными и наивными экземплярами [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) не вызывают [`TypeError`](https://python-all.ru/3.12/library/exceptions.html#TypeError).12991300В булевом контексте объект [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) всегда считается истинным.13011302Изменено в версии 3.5: До Python 3.5 объект [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) считался ложным, если он представлял полночь в UTC. Это поведение считалось неочевидным и чреватым ошибками и было удалено в Python 3.5. См. [bpo-13936](https://python-all.ru/3.12/library/datetime.html) для получения полной информации.13031304Другой конструктор:13051306#### `classmethod time.fromisoformat(time_string)`13071308Возвращает объект [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time), соответствующий строке *time\_string* в любом допустимом формате ISO 8601, со следующими исключениями:130913101. Смещения часовых поясов могут содержать доли секунды.13112. Ведущий символ `T`, обычно обязательный в случаях, когда возможна неоднозначность между датой и временем, не требуется.13123. Доли секунды могут содержать любое количество цифр (всё, что больше 6, будет усечено).13134. Доли часов и минут не поддерживаются.13141315Примеры:13161317```pycon1318>>> from datetime import time1319>>> time.fromisoformat('04:23:01')1320datetime.time(4, 23, 1)1321>>> time.fromisoformat('T04:23:01')1322datetime.time(4, 23, 1)1323>>> time.fromisoformat('T042301')1324datetime.time(4, 23, 1)1325>>> time.fromisoformat('04:23:01.000384')1326datetime.time(4, 23, 1, 384)1327>>> time.fromisoformat('04:23:01,000384')1328datetime.time(4, 23, 1, 384)1329>>> time.fromisoformat('04:23:01+04:00')1330datetime.time(4, 23, 1, tzinfo=datetime.timezone(datetime.timedelta(seconds=14400)))1331>>> time.fromisoformat('04:23:01Z')1332datetime.time(4, 23, 1, tzinfo=datetime.timezone.utc)1333>>> time.fromisoformat('04:23:01+00:00')1334datetime.time(4, 23, 1, tzinfo=datetime.timezone.utc)1335```13361337Добавлено в версии 3.7.13381339Изменено в версии 3.11: Ранее этот метод поддерживал только форматы, которые могли быть возвращены [`time.isoformat()`](https://python-all.ru/3.12/library/datetime.html#datetime.time.isoformat).13401341Методы экземпляра:13421343#### `time.replace(hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond, tzinfo=self.tzinfo, *, fold=0)`13441345Возвращает новый объект [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) с теми же значениями, но с обновлёнными указанными параметрами. Обратите внимание, что `tzinfo=None` может быть указан для создания наивного [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) из осведомлённого [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) без преобразования данных времени.13461347Изменено в версии 3.6: Добавлен параметр *fold*.13481349#### `time.isoformat(timespec='auto')`13501351Возвращает строку, представляющую время в формате ISO 8601, одну из:13521353- `HH:MM:SS.ffffff`, если [`microsecond`](https://python-all.ru/3.12/library/datetime.html#datetime.time.microsecond) не равно 01354- `HH:MM:SS`, если [`microsecond`](https://python-all.ru/3.12/library/datetime.html#datetime.time.microsecond) равно 01355- `HH:MM:SS.ffffff+HH:MM[:SS[.ffffff]]`, если [`utcoffset()`](https://python-all.ru/3.12/library/datetime.html#datetime.time.utcoffset) не возвращает `None`1356- `HH:MM:SS+HH:MM[:SS[.ffffff]]`, если [`microsecond`](https://python-all.ru/3.12/library/datetime.html#datetime.time.microsecond) равно 0 и [`utcoffset()`](https://python-all.ru/3.12/library/datetime.html#datetime.time.utcoffset) не возвращает `None`13571358Необязательный аргумент *timespec* указывает количество дополнительных компонентов времени, которые нужно включить (по умолчанию `'auto'`). Он может быть одним из следующих:13591360- `'auto'`: То же, что и `'seconds'`, если [`microsecond`](https://python-all.ru/3.12/library/datetime.html#datetime.time.microsecond) равно 0, иначе то же, что и `'microseconds'`.1361- `'hours'`: Включает [`hour`](https://python-all.ru/3.12/library/datetime.html#datetime.time.hour) в двухзначном формате `HH`.1362- `'minutes'`: Включает [`hour`](https://python-all.ru/3.12/library/datetime.html#datetime.time.hour) и [`minute`](https://python-all.ru/3.12/library/datetime.html#datetime.time.minute) в формате `HH:MM`.1363- `'seconds'`: Включает [`hour`](https://python-all.ru/3.12/library/datetime.html#datetime.time.hour), [`minute`](https://python-all.ru/3.12/library/datetime.html#datetime.time.minute) и [`second`](https://python-all.ru/3.12/library/datetime.html#datetime.time.second) в формате `HH:MM:SS`.1364- `'milliseconds'`: Включает полное время, но усекает дробную часть секунд до миллисекунд. Формат `HH:MM:SS.sss`.1365- `'microseconds'`: Включает полное время в формате `HH:MM:SS.ffffff`.13661367> **Примечание**1368>1369> Исключённые компоненты времени усекаются, а не округляются.13701371[`ValueError`](https://python-all.ru/3.12/library/exceptions.html#ValueError) будет вызвано при недопустимом аргументе *timespec*.13721373Пример:13741375```python1376>>> from datetime import time1377>>> time(hour=12, minute=34, second=56, microsecond=123456).isoformat(timespec='minutes')1378'12:34'1379>>> dt = time(hour=12, minute=34, second=56, microsecond=0)1380>>> dt.isoformat(timespec='microseconds')1381'12:34:56.000000'1382>>> dt.isoformat(timespec='auto')1383'12:34:56'1384```13851386Изменено в версии 3.6: Добавлен параметр *timespec*.13871388#### `time.__str__()`13891390Для времени `t` `str(t)` эквивалентно `t.isoformat()`.13911392#### `time.strftime(format)`13931394Возвращает строку, представляющую время, управляемую явной строкой формата. См. также [Поведение strftime() и strptime()](https://python-all.ru/3.12/library/datetime.html#strftime-strptime-behavior) и [`time.isoformat()`](https://python-all.ru/3.12/library/datetime.html#datetime.time.isoformat).13951396#### `time.__format__(format)`13971398То же, что [`time.strftime()`](https://python-all.ru/3.12/library/datetime.html#datetime.time.strftime). Это позволяет задать строку формата для объекта [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) в [форматированных строковых литералах](https://python-all.ru/3.12/reference/lexical_analysis.html#f-strings) и при использовании [`str.format()`](https://python-all.ru/3.12/library/stdtypes.html#str.format). См. также [Поведение strftime() и strptime()](https://python-all.ru/3.12/library/datetime.html#strftime-strptime-behavior) и [`time.isoformat()`](https://python-all.ru/3.12/library/datetime.html#datetime.time.isoformat).13991400#### `time.utcoffset()`14011402Если [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.time.tzinfo) равно `None`, возвращает `None`, иначе возвращает `self.tzinfo.utcoffset(None)`, и возбуждает исключение, если последнее не возвращает `None` или объект [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) с величиной менее одного дня.14031404Изменено в версии 3.7: Смещение UTC теперь не ограничено целым числом минут.14051406#### `time.dst()`14071408Если [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.time.tzinfo) равно `None`, возвращает `None`, иначе возвращает `self.tzinfo.dst(None)`, и возбуждает исключение, если последнее не возвращает `None` или объект [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) с величиной менее одного дня.14091410Изменено в версии 3.7: Смещение DST не ограничивается целым числом минут.14111412#### `time.tzname()`14131414Если [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.time.tzinfo) равно `None`, возвращает `None`, иначе возвращает `self.tzinfo.tzname(None)`, или возбуждает исключение, если последнее не возвращает `None` или строковый объект.14151416### Примеры использования: [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time)14171418Примеры работы с объектом [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time):14191420```python1421>>> from datetime import time, tzinfo, timedelta1422>>> class TZ1(tzinfo):1423...     def utcoffset(self, dt):1424...         return timedelta(hours=1)1425...     def dst(self, dt):1426...         return timedelta(0)1427...     def tzname(self,dt):1428...         return "+01:00"1429...     def  __repr__(self):1430...         return f"{self.__class__.__name__}()"1431...1432>>> t = time(12, 10, 30, tzinfo=TZ1())1433>>> t1434datetime.time(12, 10, 30, tzinfo=TZ1())1435>>> t.isoformat()1436'12:10:30+01:00'1437>>> t.dst()1438datetime.timedelta(0)1439>>> t.tzname()1440'+01:00'1441>>> t.strftime("%H:%M:%S %Z")1442'12:10:30 +01:00'1443>>> 'The {} is {:%H:%M}.'.format("time", t)1444'The time is 12:10.'1445```14461447## [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) Объекты14481449#### `class datetime.tzinfo`14501451Это абстрактный базовый класс, то есть этот класс не должен создаваться напрямую. Определите подкласс [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) для хранения информации о конкретном часовом поясе.14521453Экземпляр (конкретного подкласса) [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) можно передать конструкторам объектов [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) и [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time). Последние рассматривают свои атрибуты как местное время, а объект [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) поддерживает методы, показывающие смещение местного времени от UTC, название часового пояса и смещение DST – все относительно переданного им объекта даты или времени.14541455Необходимо создать конкретный подкласс и (как минимум) реализовать стандартные методы [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo), необходимые для используемых методов [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime). Модуль `datetime` предоставляет [`timezone`](https://python-all.ru/3.12/library/datetime.html#datetime.timezone) – простой конкретный подкласс [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo), который может представлять часовые пояса с фиксированным смещением от UTC, такие как сам UTC или североамериканские EST и EDT.14561457Особое требование для сериализации с помощью pickle: подкласс [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) должен иметь метод [`__init__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__init__), который можно вызвать без аргументов, иначе объект можно сериализовать, но возможно не удастся десериализовать обратно. Это техническое требование, которое может быть ослаблено в будущем.14581459Конкретному подклассу [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) может потребоваться реализовать следующие методы. Какие именно методы нужны, зависит от того, как используются осведомлённые (aware) объекты `datetime`. Если есть сомнения, просто реализуйте их все.14601461#### `tzinfo.utcoffset(dt)`14621463Возвращает смещение местного времени от UTC в виде объекта [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta), которое положительно к востоку от UTC. Если местное время к западу от UTC, оно должно быть отрицательным.14641465Это представляет *общее* смещение от UTC; например, если объект [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) представляет как часовой пояс, так и корректировки DST, [`utcoffset()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.utcoffset) должен возвращать их сумму. Если смещение UTC неизвестно, верните `None`. В противном случае возвращаемое значение должно быть объектом [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) строго между `-timedelta(hours=24)` и `timedelta(hours=24)` (величина смещения должна быть меньше одного дня). Большинство реализаций [`utcoffset()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.utcoffset) будут выглядеть как один из этих двух вариантов:14661467```python1468return CONSTANT                 # класс с фиксированным смещением1469return CONSTANT + self.dst(dt)  # класс, учитывающий летнее время1470```14711472Если [`utcoffset()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.utcoffset) не возвращает `None`, то [`dst()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.dst) также не должен возвращать `None`.14731474Реализация по умолчанию [`utcoffset()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.utcoffset) возбуждает [`NotImplementedError`](https://python-all.ru/3.12/library/exceptions.html#NotImplementedError).14751476Изменено в версии 3.7: Смещение UTC теперь не ограничено целым числом минут.14771478#### `tzinfo.dst(dt)`14791480Возвращает поправку на летнее время (DST) в виде объекта [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) или `None`, если информация о DST неизвестна.14811482Возвращает `timedelta(0)`, если DST не действует. Если DST действует, возвращает смещение в виде объекта [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta) (подробнее см. [`utcoffset()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.utcoffset)). Обратите внимание, что смещение DST, если применимо, уже добавлено к смещению UTC, возвращаемому [`utcoffset()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.utcoffset), поэтому нет необходимости обращаться к [`dst()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.dst), если только вы не хотите получить информацию о DST отдельно. Например, [`datetime.timetuple()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.timetuple) вызывает метод [`dst()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.dst) своего атрибута [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzinfo), чтобы определить, как должен быть установлен флаг [`tm_isdst`](https://python-all.ru/3.12/library/time.html#time.struct_time.tm_isdst), а [`tzinfo.fromutc()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.fromutc) вызывает [`dst()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.dst) для учёта изменений DST при пересечении часовых поясов.14831484Экземпляр *tz* подкласса [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo), который моделирует как стандартное, так и летнее время, должен быть согласован в следующем смысле:14851486`tz.utcoffset(dt) - tz.dst(dt)`14871488должен возвращать один и тот же результат для каждого [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) *dt* с `dt.tzinfo == tz`. Для разумных подклассов [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) это выражение даёт «стандартное смещение» часового пояса, которое не должно зависеть от даты или времени, а только от географического положения. Реализация [`datetime.astimezone()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.astimezone) полагается на это, но не может обнаружить нарушения; ответственность за это лежит на программисте. Если подкласс [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) не может этого гарантировать, он может переопределить реализацию по умолчанию [`tzinfo.fromutc()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.fromutc), чтобы она корректно работала с [`astimezone()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.astimezone) в любом случае.14891490Большинство реализаций [`dst()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.dst), вероятно, будут выглядеть как один из этих двух вариантов:14911492```python1493def dst(self, dt):1494    # класс с фиксированным смещением: не учитывает летнее время1495    return timedelta(0)1496```14971498или:14991500```python1501def dst(self, dt):1502    # Код для установки dston и dstoff в значения летнего времени часового пояса1503    # переходные моменты времени на основе входного dt.year и выраженные1504    # в стандартном местном времени.15051506    if dston <= dt.replace(tzinfo=None) < dstoff:1507        return timedelta(hours=1)1508    else:1509        return timedelta(0)1510```15111512Реализация по умолчанию [`dst()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.dst) вызывает исключение [`NotImplementedError`](https://python-all.ru/3.12/library/exceptions.html#NotImplementedError).15131514Изменено в версии 3.7: Смещение DST не ограничивается целым числом минут.15151516#### `tzinfo.tzname(dt)`15171518Возвращает название часового пояса, соответствующее объекту [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) *dt*, в виде строки. Модуль `datetime` не определяет никаких правил для строковых названий, и нет требований, чтобы они что-то конкретное означали. Например, `"GMT"`, `"UTC"`, `"-500"`, `"-5:00"`, `"EDT"`, `"US/Eastern"`, `"America/New York"` – все это допустимые ответы. Возвращает `None`, если строковое название неизвестно. Обратите внимание, что это метод, а не фиксированная строка, главным образом потому, что некоторые подклассы [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) могут возвращать разные названия в зависимости от конкретного значения переданного *dt*, особенно если класс [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) учитывает летнее время.15191520Реализация по умолчанию [`tzname()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.tzname) вызывает исключение [`NotImplementedError`](https://python-all.ru/3.12/library/exceptions.html#NotImplementedError).15211522Эти методы вызываются объектом [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) или [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) в ответ на их одноимённые методы. Объект [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) передаёт себя в качестве аргумента, а объект [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) передаёт `None`. Поэтому методы подкласса [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) должны быть готовы принять аргумент *dt* типа `None` или класса [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime).15231524Когда передаётся `None`, разработчик класса должен решить, какой ответ будет наилучшим. Например, возврат `None` уместен, если класс хочет показать, что объекты времени не участвуют в протоколах [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo). Возможно, более полезным будет, чтобы `utcoffset(None)` возвращал стандартное смещение UTC, так как нет другого соглашения для его определения.15251526Когда объект [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) передаётся в ответ на метод [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime), `dt.tzinfo` является тем же объектом, что и *self*. Методы [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) могут на это полагаться, если только пользовательский код не вызывает методы [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) напрямую. Смысл в том, что методы [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) интерпретируют *dt* как местное время и не должны беспокоиться об объектах в других часовых поясах.15271528Существует ещё один метод [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo), который подкласс может переопределить:15291530#### `tzinfo.fromutc(dt)`15311532Этот метод вызывается из реализации по умолчанию [`datetime.astimezone()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.astimezone). При таком вызове `dt.tzinfo` является *self*, а данные даты и времени *dt* рассматриваются как время UTC. Цель [`fromutc()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.fromutc) – скорректировать данные даты и времени, вернув эквивалентный datetime в местном времени *self*.15331534Большинство подклассов [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) должны без проблем наследовать реализацию по умолчанию [`fromutc()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.fromutc). Она достаточно сильна, чтобы обрабатывать часовые пояса с фиксированным смещением, а также пояса, учитывающие стандартное и летнее время, причём последние – даже если время перехода на летнее время различается в разные годы. Пример часового пояса, который реализация по умолчанию [`fromutc()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.fromutc) может обрабатывать неправильно в некоторых случаях, – это пояс, где стандартное смещение (от UTC) зависит от конкретной переданной даты и времени, что может происходить по политическим причинам. Реализации по умолчанию [`astimezone()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.astimezone) и [`fromutc()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.fromutc) могут не дать желаемого результата, если результат приходится на часы, пересекающие момент изменения стандартного смещения.15351536Опуская код для обработки ошибок, реализация по умолчанию [`fromutc()`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo.fromutc) работает следующим образом:15371538```python1539def fromutc(self, dt):1540    # вызывает ошибку ValueError, если dt.tzinfo не равен self1541    dtoff = dt.utcoffset()1542    dtdst = dt.dst()1543    # вызывает ValueError, если dtoff или dtdst равны None1544    delta = dtoff - dtdst  # это стандартное смещение self1545    if delta:1546        dt += delta   # преобразовать в стандартное местное время1547        dtdst = dt.dst()1548        # вызывает ValueError, если dtdst равен None1549    if dtdst:1550        return dt + dtdst1551    else:1552        return dt1553```15541555В следующем файле [`tzinfo_examples.py`](https://python-all.ru/3.12/_downloads/6dc1f3f4f0e6ca13cb42ddf4d6cbc8af/tzinfo_examples.py) приведены некоторые примеры классов [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo):15561557```python1558from datetime import tzinfo, timedelta, datetime15591560ZERO = timedelta(0)1561HOUR = timedelta(hours=1)1562SECOND = timedelta(seconds=1)15631564# Класс, отражающий представление платформы о местном времени.1565# (Может приводить к неверным значениям для исторических моментов в1566#  часовых поясах, где UTC-смещение и/или правила летнего времени1567#  менялись в прошлом.)1568import time as _time15691570STDOFFSET = timedelta(seconds = -_time.timezone)1571if _time.daylight:1572    DSTOFFSET = timedelta(seconds = -_time.altzone)1573else:1574    DSTOFFSET = STDOFFSET15751576DSTDIFF = DSTOFFSET - STDOFFSET15771578class LocalTimezone(tzinfo):15791580    def fromutc(self, dt):1581        assert dt.tzinfo is self1582        stamp = (dt - datetime(1970, 1, 1, tzinfo=self)) // SECOND1583        args = _time.localtime(stamp)[:6]1584        dst_diff = DSTDIFF // SECOND1585        # Обнаружение fold1586        fold = (args == _time.localtime(stamp - dst_diff))1587        return datetime(*args, microsecond=dt.microsecond,1588                        tzinfo=self, fold=fold)15891590    def utcoffset(self, dt):1591        if self._isdst(dt):1592            return DSTOFFSET1593        else:1594            return STDOFFSET15951596    def dst(self, dt):1597        if self._isdst(dt):1598            return DSTDIFF1599        else:1600            return ZERO16011602    def tzname(self, dt):1603        return _time.tzname[self._isdst(dt)]16041605    def _isdst(self, dt):1606        tt = (dt.year, dt.month, dt.day,1607              dt.hour, dt.minute, dt.second,1608              dt.weekday(), 0, 0)1609        stamp = _time.mktime(tt)1610        tt = _time.localtime(stamp)1611        return tt.tm_isdst > 016121613Local = LocalTimezone()16141615# Полная реализация текущих правил летнего времени для основных часовых поясов США.16161617def first_sunday_on_or_after(dt):1618    days_to_go = 6 - dt.weekday()1619    if days_to_go:1620        dt += timedelta(days_to_go)1621    return dt16221623# Правила летнего времени в США1624#1625# Это упрощённый набор правил для США (т.е. неверный для некоторых случаев)1626# времени начала и окончания летнего времени. Полный и актуальный набор правил летнего времени1627# и определений часовых поясов смотрите в базе данных Olson (или попробуйте pytz):1628# http://www.twinsun.com/tz/tz-link.htm1629# https://sourceforge.net/projects/pytz/ (возможно, не актуально)1630#1631# В США с 2007 года летнее время начинается в 2 часа ночи (стандартное время) во второе1632# воскресенье марта, то есть первое воскресенье 8 марта или после него.1633DSTSTART_2007 = datetime(1, 3, 8, 2)1634# и заканчивается в 2 часа ночи (летнее время) в первое воскресенье ноября.1635DSTEND_2007 = datetime(1, 11, 1, 2)1636# С 1987 по 2006 год летнее время начиналось в 2 часа ночи (стандартное время) в первое1637# воскресенье апреля и заканчивалось в 2 часа ночи (летнее время) в последнее1638# воскресенье октября, то есть первое воскресенье 25 октября или после него.1639DSTSTART_1987_2006 = datetime(1, 4, 1, 2)1640DSTEND_1987_2006 = datetime(1, 10, 25, 2)1641# С 1967 по 1986 год летнее время начиналось в 2 часа ночи (стандартное время) в последнее1642# воскресенье апреля (то есть 24 апреля или после него) и заканчивалось в 2 часа ночи (летнее время)1643# в последнее воскресенье октября, которое является первым воскресеньем1644# 25 октября или позднее.1645DSTSTART_1967_1986 = datetime(1, 4, 24, 2)1646DSTEND_1967_1986 = DSTEND_1987_200616471648def us_dst_range(year):1649    # Найти время начала и окончания перехода на летнее время в США. Для лет до 1967 года вернуть1650    # start = end, если летнее время не применяется.1651    if 2006 < year:1652        dststart, dstend = DSTSTART_2007, DSTEND_20071653    elif 1986 < year < 2007:1654        dststart, dstend = DSTSTART_1987_2006, DSTEND_1987_20061655    elif 1966 < year < 1987:1656        dststart, dstend = DSTSTART_1967_1986, DSTEND_1967_19861657    else:1658        return (datetime(year, 1, 1), ) * 216591660    start = first_sunday_on_or_after(dststart.replace(year=year))1661    end = first_sunday_on_or_after(dstend.replace(year=year))1662    return start, end16631664class USTimeZone(tzinfo):16651666    def __init__(self, hours, reprname, stdname, dstname):1667        self.stdoffset = timedelta(hours=hours)1668        self.reprname = reprname1669        self.stdname = stdname1670        self.dstname = dstname16711672    def __repr__(self):1673        return self.reprname16741675    def tzname(self, dt):1676        if self.dst(dt):1677            return self.dstname1678        else:1679            return self.stdname16801681    def utcoffset(self, dt):1682        return self.stdoffset + self.dst(dt)16831684    def dst(self, dt):1685        if dt is None or dt.tzinfo is None:1686            # В одном или обоих случаях здесь может быть уместно исключение.1687            # Это зависит от того, как вы хотите их обрабатывать. Реализация по умолчанию1688            # fromutc() (вызываемая реализацией astimezone() по умолчанию)1689            # реализация) передаёт datetime с dt.tzinfo равным self.1690            return ZERO1691        assert dt.tzinfo is self1692        start, end = us_dst_range(dt.year)1693        # Нельзя сравнивать наивные и осведомлённые объекты, поэтому сначала удалите часовой пояс из1694        # сначала dt.1695        dt = dt.replace(tzinfo=None)1696        if start + HOUR <= dt < end - HOUR:1697            # Действует летнее время.1698            return HOUR1699        if end - HOUR <= dt < end:1700            # Сложить (неоднозначный час): используйте dt.fold для разрешения неоднозначности.1701            return ZERO if dt.fold else HOUR1702        if start <= dt < start + HOUR:1703            # Gap (несуществующий час): примените обратное правило fold.1704            return HOUR if dt.fold else ZERO1705        # Летнее время не действует.1706        return ZERO17071708    def fromutc(self, dt):1709        assert dt.tzinfo is self1710        start, end = us_dst_range(dt.year)1711        start = start.replace(tzinfo=self)1712        end = end.replace(tzinfo=self)1713        std_time = dt + self.stdoffset1714        dst_time = std_time + HOUR1715        if end <= dst_time < end + HOUR:1716            # Повторяющийся час1717            return std_time.replace(fold=1)1718        if std_time < start or dst_time >= end:1719            # Стандартное время1720            return std_time1721        if start <= std_time < end - HOUR:1722            # Летнее время1723            return dst_time17241725Eastern  = USTimeZone(-5, "Eastern",  "EST", "EDT")1726Central  = USTimeZone(-6, "Central",  "CST", "CDT")1727Mountain = USTimeZone(-7, "Mountain", "MST", "MDT")1728Pacific  = USTimeZone(-8, "Pacific",  "PST", "PDT")1729```17301731Обратите внимание, что в подклассе [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo), учитывающем как стандартное, так и летнее время, дважды в год в точках перехода на летнее время возникают неизбежные тонкости. Для конкретики рассмотрим восточное время США (UTC -0500), где EDT начинается через минуту после 1:59 (EST) во второе воскресенье марта и заканчивается через минуту после 1:59 (EDT) в первое воскресенье ноября:17321733```python1734  UTC   3:MM  4:MM  5:MM  6:MM  7:MM  8:MM1735  EST  22:MM 23:MM  0:MM  1:MM  2:MM  3:MM1736  EDT  23:MM  0:MM  1:MM  2:MM  3:MM  4:MM17371738start  22:MM 23:MM  0:MM  1:MM  3:MM  4:MM17391740  end  23:MM  0:MM  1:MM  1:MM  2:MM  3:MM1741```17421743Когда начинается летнее время (строка «start»), местные настенные часы перескакивают с 1:59 на 3:00. Местное время вида 2:MM в этот день не имеет смысла, поэтому `astimezone(Eastern)` не вернёт результат с `hour == 2` в день начала DST. Например, при переходе на летнее время весной 2016 года мы получаем:17441745```python1746>>> from datetime import datetime, timezone1747>>> from tzinfo_examples import HOUR, Eastern1748>>> u0 = datetime(2016, 3, 13, 5, tzinfo=timezone.utc)1749>>> for i in range(4):1750...     u = u0 + i*HOUR1751...     t = u.astimezone(Eastern)1752...     print(u.time(), 'UTC =', t.time(), t.tzname())1753...175405:00:00 UTC = 00:00:00 EST175506:00:00 UTC = 01:00:00 EST175607:00:00 UTC = 03:00:00 EDT175708:00:00 UTC = 04:00:00 EDT1758```17591760Когда заканчивается летнее время (строка «end»), возникает потенциально более серьёзная проблема: есть час, который невозможно однозначно выразить в местном настенном времени – последний час летнего времени. В восточном поясе это время вида 5:MM UTC в день окончания летнего времени. Местные настенные часы перескакивают с 1:59 (летнее время) обратно на 1:00 (стандартное время). Местные времена вида 1:MM становятся неоднозначными. [`astimezone()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.astimezone) имитирует поведение местных часов, отображая два соседних часа UTC в один и тот же местный час. В примере с восточным поясом времена UTC вида 5:MM и 6:MM оба отображаются в 1:MM при преобразовании в восточное время, но у более ранних времен атрибут [`fold`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.fold) установлен в 0, а у более поздних – в 1. Например, при переходе на зимнее время осенью 2016 года мы получаем:17611762```python1763>>> u0 = datetime(2016, 11, 6, 4, tzinfo=timezone.utc)1764>>> for i in range(4):1765...     u = u0 + i*HOUR1766...     t = u.astimezone(Eastern)1767...     print(u.time(), 'UTC =', t.time(), t.tzname(), t.fold)1768...176904:00:00 UTC = 00:00:00 EDT 0177005:00:00 UTC = 01:00:00 EDT 0177106:00:00 UTC = 01:00:00 EST 1177207:00:00 UTC = 02:00:00 EST 01773```17741775Обратите внимание, что экземпляры [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime), отличающиеся только значением атрибута [`fold`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.fold), считаются равными при сравнении.17761777Приложения, которые не могут мириться с неоднозначностью местного времени, должны явно проверять значение атрибута [`fold`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.fold) или избегать использования гибридных подклассов [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo); неоднозначности отсутствуют при использовании [`timezone`](https://python-all.ru/3.12/library/datetime.html#datetime.timezone) или любого другого подкласса [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo) с фиксированным смещением (например, класс, представляющий только EST (фиксированное смещение -5 часов) или только EDT (фиксированное смещение -4 часа)).17781779> **См. также**1780>1781> > **[`zoneinfo`](https://python-all.ru/3.12/library/zoneinfo.html#module-zoneinfo)**1782> >1783> > Модуль `datetime` содержит базовый класс [`timezone`](https://python-all.ru/3.12/library/datetime.html#datetime.timezone) (для обработки произвольных фиксированных смещений от UTC) и его атрибут [`timezone.utc`](https://python-all.ru/3.12/library/datetime.html#datetime.timezone.utc) (экземпляр UTC `timezone`).1784> >1785> > `zoneinfo` предоставляет Python базу данных *IANA time zone database* (также известную как база данных Olson), и её использование рекомендуется.1786>1787> **[база данных часовых поясов IANA](https://python-all.ru/3.12/library/datetime.html)**1788>1789> База данных часовых поясов (часто называемая tz, tzdata или zoneinfo) содержит код и данные, представляющие историю местного времени для множества характерных мест по всему миру. Она периодически обновляется, чтобы отражать изменения, вносимые политическими органами в границы часовых поясов, смещения UTC и правила перехода на летнее время.17901791## [`timezone`](https://python-all.ru/3.12/library/datetime.html#datetime.timezone) Объекты17921793Класс [`timezone`](https://python-all.ru/3.12/library/datetime.html#datetime.timezone) является подклассом [`tzinfo`](https://python-all.ru/3.12/library/datetime.html#datetime.tzinfo), каждый экземпляр которого представляет часовой пояс, определяемый фиксированным смещением от UTC.17941795Объекты этого класса нельзя использовать для представления информации о часовом поясе в местах, где в разные дни года используются разные смещения или где в гражданское время вносились исторические изменения.17961797#### `class datetime.timezone(offset, name=None)`17981799Аргумент *offset* должен быть задан как объект [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta), представляющий разницу между местным временем и UTC. Он должен находиться строго между `-timedelta(hours=24)` и `timedelta(hours=24)`, в противном случае возникает исключение [`ValueError`](https://python-all.ru/3.12/library/exceptions.html#ValueError).18001801Аргумент *name* необязателен. Если он указан, это должна быть строка, которая будет использоваться в качестве значения, возвращаемого методом [`datetime.tzname()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzname).18021803Добавлено в версии 3.2.18041805Изменено в версии 3.7: Смещение UTC теперь не ограничено целым числом минут.18061807#### `timezone.utcoffset(dt)`18081809Возвращает фиксированное значение, указанное при создании экземпляра [`timezone`](https://python-all.ru/3.12/library/datetime.html#datetime.timezone).18101811Аргумент *dt* игнорируется. Возвращаемое значение – экземпляр [`timedelta`](https://python-all.ru/3.12/library/datetime.html#datetime.timedelta), равный разнице между местным временем и UTC.18121813Изменено в версии 3.7: Смещение UTC теперь не ограничено целым числом минут.18141815#### `timezone.tzname(dt)`18161817Возвращает фиксированное значение, указанное при создании экземпляра [`timezone`](https://python-all.ru/3.12/library/datetime.html#datetime.timezone).18181819Если *name* не указан в конструкторе, имя, возвращаемое `tzname(dt)`, генерируется из значения `offset` следующим образом. Если *offset* равно `timedelta(0)`, то имя – «UTC», иначе это строка в формате `UTC±HH:MM`, где ± – это знак `offset`, HH и MM – две цифры `offset.hours` и `offset.minutes` соответственно.18201821Изменено в версии 3.6: Имя, генерируемое из `offset=timedelta(0)`, теперь является обычным `'UTC'`, а не `'UTC+00:00'`.18221823#### `timezone.dst(dt)`18241825Всегда возвращает `None`.18261827#### `timezone.fromutc(dt)`18281829Возвращает `dt + offset`. Аргумент *dt* должен быть осведомлённым экземпляром [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime), с `tzinfo`, установленным в `self`.18301831Атрибуты класса:18321833#### `timezone.utc`18341835Часовой пояс UTC, `timezone(timedelta(0))`.18361837## [`strftime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strftime) и [`strptime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strptime) Поведение18381839Объекты [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date), [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) и [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) поддерживают метод `strftime(format)`, который создаёт строку, представляющую время с использованием явной строки формата.18401841И наоборот, метод класса [`datetime.strptime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strptime) создаёт объект [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) из строки, представляющей дату и время, и соответствующей строки формата.18421843Приведённая ниже таблица даёт высокоуровневое сравнение [`strftime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strftime) и [`strptime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strptime):18441845|  | `strftime` | `strptime` |1846| --- | --- | --- |1847| Использование | Преобразовать объект в строку по заданному формату | Разбирает строку в объект [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) по соответствующему формату. |1848| Тип метода | Метод экземпляра | Метод класса |1849| Метод | [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date); [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime); [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) | [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime) |1850| Сигнатура | `strftime(format)` | `strptime(date_string, format)` |18511852>18531854### [`strftime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strftime) и [`strptime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strptime) Коды форматов18551856Эти методы принимают коды формата, которые можно использовать для разбора и форматирования дат:18571858```python1859>>> datetime.strptime('31/01/22 23:59:59.999999',1860...                   '%d/%m/%y %H:%M:%S.%f')1861datetime.datetime(2022, 1, 31, 23, 59, 59, 999999)1862>>> _.strftime('%a %d %b %Y, %I:%M%p')1863'Mon 31 Jan 2022, 11:59PM'1864```18651866Ниже приведён список всех кодов формата, требуемых стандартом C 1989 года, и они работают на всех платформах со стандартной реализацией C.18671868| Директива | Значение | Пример | Примечания |1869| --- | --- | --- | --- |1870| `%a` | День недели как сокращённое название в локали. | Sun, Mon, …, Sat (en\_US); So, Mo, …, Sa (de\_DE) | (1) |1871| `%A` | Название дня недели в полной форме, зависящее от локали. | Sunday, Monday, …, Saturday (en\_US); Sonntag, Montag, …, Samstag (de\_DE) | (1) |1872| `%w` | День недели в виде десятичного числа, где 0 – воскресенье, а 6 – суббота. | 0, 1, …, 6 |  |1873| `%d` | День месяца в виде десятичного числа, дополненного слева нулями. | 01, 02, …, 31 | (9) |1874| `%b` | Название месяца в сокращённой форме, зависящей от локали. | Jan, Feb, …, Dec (en\_US); Jan, Feb, …, Dez (de\_DE) | (1) |1875| `%B` | Название месяца в полной форме, зависящей от локали. | January, February, …, December (en\_US); Januar, Februar, …, Dezember (de\_DE) | (1) |1876| `%m` | Месяц в виде десятичного числа, дополненного слева нулями. | 01, 02, …, 12 | (9) |1877| `%y` | Год без столетия в виде десятичного числа, дополненного слева нулями. | 00, 01, …, 99 | (9) |1878| `%Y` | Год со столетием в виде десятичного числа. | 0001, 0002, …, 2013, 2014, …, 9998, 9999 | (2) |1879| `%H` | Часы (в 24-часовом формате) в виде десятичного числа, дополненного слева нулями. | 00, 01, …, 23 | (9) |1880| `%I` | Часы (в 12-часовом формате) в виде десятичного числа, дополненного слева нулями. | 01, 02, …, 12 | (9) |1881| `%p` | Эквивалент AM или PM, зависящий от локали. | AM, PM (en\_US); am, pm (de\_DE) | (1), (3) |1882| `%M` | Минуты в виде десятичного числа, дополненного слева нулями. | 00, 01, …, 59 | (9) |1883| `%S` | Секунды в виде десятичного числа, дополненного слева нулями. | 00, 01, …, 59 | (4), (9) |1884| `%f` | Микросекунды в виде десятичного числа, дополненного слева нулями до 6 цифр. | 000000, 000001, …, 999999 | (5) |1885| `%z` | Смещение UTC в формате `±HHMM[SS[.ffffff]]` (пустая строка, если объект наивный). | (пусто), +0000, -0400, +1030, +063415, -030712.345216 | (6) |1886| `%Z` | Название часового пояса (пустая строка, если объект наивный). | (пусто), UTC, GMT | (6) |1887| `%j` | День года в виде десятичного числа, дополненного слева нулями. | 001, 002, …, 366 | (9) |1888| `%U` | Номер недели в году (воскресенье – первый день недели) в виде десятичного числа, дополненного слева нулями. Все дни в новом году до первого воскресенья считаются неделей 0. | 00, 01, …, 53 | (7), (9) |1889| `%W` | Номер недели в году (понедельник – первый день недели) в виде десятичного числа, дополненного слева нулями. Все дни в новом году до первого понедельника считаются неделей 0. | 00, 01, …, 53 | (7), (9) |1890| `%c` | Представление даты и времени, подходящее для локали. | Tue Aug 16 21:30:00 1988 (en\_US); Di 16 Aug 21:30:00 1988 (de\_DE) | (1) |1891| `%x` | Представление даты, соответствующее локали. | 08/16/88 (None); 08/16/1988 (en\_US); 16.08.1988 (de\_DE) | (1) |1892| `%X` | Представление времени, соответствующее локали. | 21:30:00 (en\_US); 21:30:00 (de\_DE) | (1) |1893| `%%` | Литеральный символ `'%'`. | % |  |18941895Для удобства включено несколько дополнительных директив, не требуемых стандартом C89. Все эти параметры соответствуют значениям дат ISO 8601.18961897| Директива | Значение | Пример | Примечания |1898| --- | --- | --- | --- |1899| `%G` | Год по ISO 8601 с веком, представляющий год, который содержит большую часть недели по ISO 8601 (`%V`). | 0001, 0002, …, 2013, 2014, …, 9998, 9999 | (8) |1900| `%u` | День недели по ISO 8601 в виде десятичного числа, где 1 – понедельник. | 1, 2, …, 7 |  |1901| `%V` | Неделя по ISO 8601 в виде десятичного числа, где понедельник считается первым днём недели. Неделя 01 – это неделя, содержащая 4 января. | 01, 02, …, 53 | (8), (9) |1902| `%:z` | Смещение UTC в формате `±HH:MM[:SS[.ffffff]]` (пустая строка, если объект наивный). | (пусто), +00:00, -04:00, +10:30, +06:34:15, -03:07:12.345216 | (6) |19031904Они могут быть доступны не на всех платформах при использовании с методом [`strftime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strftime). Директивы года по ISO 8601 и недели по ISO 8601 не взаимозаменяемы с указанными выше директивами года и номера недели. Вызов [`strptime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strptime) с неполными или неоднозначными директивами ISO 8601 приведёт к возникновению [`ValueError`](https://python-all.ru/3.12/library/exceptions.html#ValueError).19051906Полный набор поддерживаемых кодов формата зависит от платформы, поскольку Python вызывает функцию `strftime()` из библиотеки C платформы, а различия между платформами распространены. Чтобы увидеть полный набор кодов формата, поддерживаемых на вашей платформе, обратитесь к документации *[strftime(3)](https://python-all.ru/3.12/library/datetime.html)*. Также существуют различия между платформами в обработке неподдерживаемых спецификаторов формата.19071908Добавлено в версии 3.6: `%G`, `%u` и `%V` были добавлены.19091910Добавлено в версии 3.12: `%:z` был добавлен.19111912### Технические детали19131914В целом, `d.strftime(fmt)` действует как [`time`](https://python-all.ru/3.12/library/time.html#module-time) из модуля `time.strftime(fmt, d.timetuple())`, хотя не все объекты поддерживают метод [`timetuple()`](https://python-all.ru/3.12/library/datetime.html#datetime.date.timetuple).19151916Для метода класса [`datetime.strptime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strptime) значением по умолчанию является `1900-01-01T00:00:00.000`: любые компоненты, не указанные в строке формата, будут взяты из значения по умолчанию.19171918> **Примечание**1919>1920> При использовании для разбора частичных дат без года, [`strptime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strptime) вызовет исключение при встрече 29 февраля, так как год по умолчанию 1900 *не* високосный. Всегда добавляйте високосный год по умолчанию к строкам частичных дат перед разбором.19211922```pycon1923>>> from datetime import datetime1924>>> value = "2/29"1925>>> datetime.strptime(value, "%m/%d")1926Traceback (most recent call last):1927...1928ValueError: day is out of range for month1929>>> datetime.strptime(f"1904 {value}", "%Y %m/%d")1930datetime.datetime(1904, 2, 29, 0, 0)1931```19321933Использование `datetime.strptime(date_string, format)` эквивалентно:19341935```python1936datetime(*(time.strptime(date_string, format)[0:6]))1937```19381939за исключением случаев, когда формат включает компоненты долей секунды или информацию о часовом поясе, которые поддерживаются в `datetime.strptime`, но отбрасываются `time.strptime`.19401941Для объектов [`time`](https://python-all.ru/3.12/library/datetime.html#datetime.time) не следует использовать коды формата для года, месяца и дня, поскольку у объектов `time` таких значений нет. Если они всё же используются, для года подставляется 1900, а для месяца и дня – 1.19421943Для объектов [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date) не следует использовать коды формата для часов, минут, секунд и микросекунд, поскольку у объектов [`date`](https://python-all.ru/3.12/library/datetime.html#datetime.date) таких значений нет. Если они всё же используются, для них подставляется 0.19441945По той же причине обработка строк формата, содержащих кодовые точки Unicode, которые не могут быть представлены в кодировке текущей локали, также зависит от платформы. На некоторых платформах такие кодовые точки сохраняются в выходных данных без изменений, в то время как на других `strftime` может вызвать [`UnicodeError`](https://python-all.ru/3.12/library/exceptions.html#UnicodeError) или вернуть пустую строку.19461947Примечания:194819491. Поскольку формат зависит от текущей локали, следует проявлять осторожность при построении предположений о выходном значении. Порядок полей различается (например, «месяц/день/год» против «день/месяц/год»), и вывод может содержать не-ASCII символы.19502. Метод [`strptime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strptime) может разбирать годы в полном диапазоне \[1, 9999\], но годы \< 1000 должны быть дополнены нулями до 4-значной ширины.19511952   Изменено в версии 3.2: В предыдущих версиях метод [`strftime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strftime) был ограничен gодами \>= 1900.19531954   Изменено в версии 3.3: В версии 3.2 метод [`strftime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strftime) был ограничен gодами \>= 1000.19553. При использовании с методом [`strptime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strptime) директива `%p` влияет только на поле вывода часа, если директива `%I` используется для разбора часа.19564. В отличие от модуля [`time`](https://python-all.ru/3.12/library/time.html#module-time), модуль `datetime` не поддерживает високосные секунды.19575. При использовании с методом [`strptime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strptime) директива `%f` принимает от одной до шести цифр и дополняет нулями справа. `%f` является расширением набора символов форматирования в стандарте C (но реализован отдельно в объектах datetime, поэтому всегда доступен).19586. Для наивного объекта коды форматирования `%z`, `%:z` и `%Z` заменяются пустыми строками.19591960   Для осведомлённого объекта:19611962   **`%z`**19631964   [`utcoffset()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.utcoffset) преобразуется в строку вида `±HHMM[SS[.ffffff]]`, где `HH` – двухсимвольная строка, задающая количество часов смещения UTC, `MM` – двухсимвольная строка, задающая количество минут смещения UTC, `SS` – двухсимвольная строка, задающая количество секунд смещения UTC, а `ffffff` – шестисимвольная строка, задающая количество микросекунд смещения UTC. Часть `ffffff` опускается, если смещение составляет целое число секунд, а части `ffffff` и `SS` опускаются, если смещение составляет целое число минут. Например, если [`utcoffset()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.utcoffset) возвращает `timedelta(hours=-3, minutes=-30)`, то `%z` заменяется строкой `'-0330'`.19651966   Изменено в версии 3.7: Смещение UTC теперь не ограничено целым числом минут.19671968   Изменено в версии 3.7: Когда директива `%z` передаётся методу [`strptime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strptime), смещения UTC могут содержать двоеточие в качестве разделителя между часами, минутами и секундами. Например, `'+01:00:00'` будет разобрано как смещение в один час. Кроме того, указание `'Z'` эквивалентно `'+00:00'`.19691970   **`%:z`**19711972   Ведёт себя точно так же, как `%z`, но с добавлением двоеточия в качестве разделителя между часами, минутами и секундами.19731974   **`%Z`**19751976   В [`strftime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strftime) `%Z` заменяется пустой строкой, если [`tzname()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.tzname) возвращает `None`; в противном случае `%Z` заменяется возвращённым значением, которое должно быть строкой.19771978   [`strptime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strptime) принимает только определённые значения для `%Z`:19791980   1. любое значение из `time.tzname` для локали вашей системы1981   2. жёстко заданные значения `UTC` и `GMT`19821983   Так, человек, живущий в Японии, может иметь `JST`, `UTC` и `GMT` в качестве допустимых значений, но, вероятно, не `EST`. Для недопустимых значений будет возбуждено `ValueError`.19841985   Изменено в версии 3.2: Когда директива `%z` передаётся методу [`strptime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strptime), будет создан осведомлённый объект [`datetime`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime). Атрибут `tzinfo` результата будет установлен в экземпляр [`timezone`](https://python-all.ru/3.12/library/datetime.html#datetime.timezone).19867. При использовании с методом [`strptime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strptime) `%U` и `%W` используются только в вычислениях, когда указаны день недели и календарный год (`%Y`).19878. Аналогично `%U` и `%W`, `%V` используется только в вычислениях, когда день недели и год по ISO (`%G`) указаны в строке форматирования [`strptime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strptime). Также обратите внимание, что `%G` и `%Y` не являются взаимозаменяемыми.19889. При использовании с методом [`strptime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strptime) ведущий ноль является необязательным для форматов `%d`, `%m`, `%H`, `%I`, `%M`, `%S`, `%j`, `%U`, `%W` и `%V`. Формат `%y` требует ведущего нуля.198910. Разбор дат без года с помощью [`strptime()`](https://python-all.ru/3.12/library/datetime.html#datetime.datetime.strptime) завершится ошибкой для представлений 29 февраля, так как такой даты не существует в году по умолчанию 1900.19901991Сноски19921993\[[1](https://python-all.ru/3.12/library/datetime.html#id1)\]19941995Если, конечно, не учитывать эффекты теории относительности19961997\[[2](https://python-all.ru/3.12/library/datetime.html#id2)\]19981999Это соответствует определению пролептического григорианского календаря в книге Дершовица и Рейнгольда *Calendrical Calculations*, где он является базовым календарём для всех вычислений. Смотрите книгу для алгоритмов преобразования между пролептическими григорианскими порядковыми номерами и многими другими календарными системами.20002001\[[3](https://python-all.ru/3.12/library/datetime.html#id3)\]20022003Смотрите [руководство по математике календаря ISO 8601](https://python-all.ru/3.12/library/datetime.html) Р. Х. ван Гента для хорошего объяснения.2004