datetime.md

1> **Источник:** https://python-all.ru/3.13/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.13/Lib/datetime.py)1011---1213Модуль `datetime` предоставляет классы для работы с датами и временем.1415Хотя арифметика дат и времени поддерживается, основное внимание в реализации уделяется эффективному извлечению атрибутов для форматирования и обработки вывода.1617> **Совет**18>19> Перейти к [кодам форматирования](https://python-all.ru/3.13/library/datetime.html#format-codes).2021> **См. также**22>23> **Модуль [`calendar`](https://python-all.ru/3.13/library/calendar.html#module-calendar)**24>25> Общие функции, связанные с календарём.26>27> **Модуль [`time`](https://python-all.ru/3.13/library/time.html#module-time)**28>29> Доступ к времени и преобразования.30>31> **Модуль [`zoneinfo`](https://python-all.ru/3.13/library/zoneinfo.html#module-zoneinfo)**32>33> Конкретные часовые пояса, представляющие базу данных часовых поясов IANA.34>35> **Пакет [dateutil](https://python-all.ru/3.13/library/datetime.html)**36>37> Сторонняя библиотека с расширенной поддержкой часовых поясов и разбора.38>39> **Пакет [DateType](https://python-all.ru/3.13/library/datetime.html)**40>41> Сторонняя библиотека, которая вводит отдельные статические типы, позволяя, например, [статическим проверкам типов](https://python-all.ru/3.13/glossary.html#term-static-type-checker) различать наивные и осведомлённые объекты datetime.4243## Осведомлённые и наивные объекты4445Объекты даты и времени могут быть отнесены к категории «осведомлённых» или «наивных» в зависимости от того, содержат ли они информацию о часовом поясе.4647При достаточном знании применимых алгоритмических и политических поправок времени, таких как информация о часовом поясе и переходе на летнее время, **осведомлённый** объект может определить своё положение относительно других осведомлённых объектов. Осведомлённый объект представляет конкретный момент времени, не допускающий неоднозначного толкования. [\[1\]](https://python-all.ru/3.13/library/datetime.html#id4)4849**Наивный** объект не содержит достаточно информации, чтобы однозначно определить своё положение относительно других объектов даты/времени. Представляет ли наивный объект Всемирное координированное время (UTC), местное время или время в другом часовом поясе – это полностью зависит от программы, так же как от программы зависит, представляет ли конкретное число метры, мили или массу. Наивные объекты легко понять и использовать, ценой игнорирования некоторых аспектов реальности.5051Для приложений, требующих осведомлённых объектов, объекты [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) и [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) имеют необязательный атрибут информации о часовом поясе `tzinfo`, который может быть установлен в экземпляр подкласса абстрактного класса `tzinfo`. Эти объекты [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo) содержат информацию о смещении от UTC, названии часового пояса и о том, действует ли летнее время.5253Только один конкретный класс [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo), класс [`timezone`](https://python-all.ru/3.13/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.13/library/datetime.html#datetime.date) или [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime). [`MINYEAR`](https://python-all.ru/3.13/library/datetime.html#datetime.MINYEAR) равен 1.6263#### `datetime.MAXYEAR`6465Наибольший номер года, допустимый в объекте [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date) или [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime). [`MAXYEAR`](https://python-all.ru/3.13/library/datetime.html#datetime.MAXYEAR) равен 9999.6667#### `datetime.UTC`6869Псевдоним для синглтона часового пояса UTC [`datetime.timezone.utc`](https://python-all.ru/3.13/library/datetime.html#datetime.timezone.utc).7071Добавлено в версии 3.12.7273## Доступные типы7475#### `class datetime.date`7677Идеализированная наивная дата, предполагающая, что текущий григорианский календарь действовал всегда и будет действовать всегда. Атрибуты: [`year`](https://python-all.ru/3.13/library/datetime.html#datetime.date.year), [`month`](https://python-all.ru/3.13/library/datetime.html#datetime.date.month) и [`day`](https://python-all.ru/3.13/library/datetime.html#datetime.date.day).7879#### `class datetime.time`8081Идеализированное время, независимое от какого-либо конкретного дня, предполагающее, что каждый день содержит ровно 24\*60\*60 секунд. (Здесь нет понятия «високосные секунды».) Атрибуты: [`hour`](https://python-all.ru/3.13/library/datetime.html#datetime.time.hour), [`minute`](https://python-all.ru/3.13/library/datetime.html#datetime.time.minute), [`second`](https://python-all.ru/3.13/library/datetime.html#datetime.time.second), [`microsecond`](https://python-all.ru/3.13/library/datetime.html#datetime.time.microsecond) и [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.time.tzinfo).8283#### `class datetime.datetime`8485Комбинация даты и времени. Атрибуты: [`year`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.year), [`month`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.month), [`day`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.day), [`hour`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.hour), [`minute`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.minute), [`second`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.second), [`microsecond`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.microsecond), и [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo).8687#### `class datetime.timedelta`8889Длительность, представляющая разницу между двумя экземплярами [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) или [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date) с точностью до микросекунды.9091#### `class datetime.tzinfo`9293Абстрактный базовый класс для объектов информации о часовых поясах. Они используются классами [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) и [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) для предоставления настраиваемого понятия коррекции времени (например, для учёта часового пояса и/или летнего времени).9495#### `class datetime.timezone`9697Класс, реализующий абстрактный базовый класс [`tzinfo`](https://python-all.ru/3.13/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.13/library/datetime.html#datetime.date), [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime), [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) и [`timezone`](https://python-all.ru/3.13/library/datetime.html#datetime.timezone) имеют следующие общие особенности:118119- Объекты этих типов неизменяемы.120- Объекты этих типов являются [хешируемыми](https://python-all.ru/3.13/glossary.html#term-hashable), то есть могут использоваться в качестве ключей словаря.121- Объекты этих типов поддерживают эффективную сериализацию с помощью модуля [`pickle`](https://python-all.ru/3.13/library/pickle.html#module-pickle).122123### Определение, является ли объект осведомлённым или наивным124125Объекты типа [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date) всегда naive.126127Объект типа [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) или [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) может быть aware или naive.128129Объект [`datetime`](https://python-all.ru/3.13/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.13/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.13/library/datetime.html#datetime.timedelta) .144145## [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) Объекты146147Объект [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) представляет длительность, разницу между двумя экземплярами [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) или [`date`](https://python-all.ru/3.13/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>>> import datetime as dt170>>> delta = dt.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> **Совет**185>186> `import datetime as dt` вместо `import datetime` или `from datetime import datetime`, чтобы избежать путаницы между модулем и классом. См. [Как я импортирую модуль datetime в Python](https://python-all.ru/3.13/library/datetime.html).187188Если какой-либо аргумент является числом с плавающей запятой и есть дробные микросекунды, то дробные микросекунды, оставшиеся от всех аргументов, объединяются, и их сумма округляется до ближайшей микросекунды с использованием правила округления до ближайшего чётного. Если ни один аргумент не является числом с плавающей запятой, процессы преобразования и нормализации являются точными (информация не теряется).189190Если нормализованное значение дней выходит за указанный диапазон, возбуждается [`OverflowError`](https://python-all.ru/3.13/library/exceptions.html#OverflowError).191192Обратите внимание, что нормализация отрицательных значений может сначала показаться неожиданной. Например:193194```python195>>> import datetime as dt196>>> d = dt.timedelta(microseconds=-1)197>>> (d.days, d.seconds, d.microseconds)198(-1, 86399, 999999)199```200201Поскольку строковое представление объектов `timedelta` может сбивать с толку, используйте следующий рецепт, чтобы получить более читаемый формат:202203```pycon204>>> def pretty_timedelta(td):205...     if td.days >= 0:206...         return str(td)207...     return f'-({-td!s})'208...209>>> d = timedelta(hours=-1)210>>> str(d)  # неудобно для человека211'-1 day, 23:00:00'212>>> pretty_timedelta(d)213'-(1:00:00)'214```215216Атрибуты класса:217218#### `timedelta.min`219220Наиболее отрицательный объект [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta), `timedelta(-999999999)`.221222#### `timedelta.max`223224Наиболее положительный объект [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta), `timedelta(days=999999999, hours=23, minutes=59, seconds=59, microseconds=999999)`.225226#### `timedelta.resolution`227228Наименьшая возможная разница между неравными [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) объектами, `timedelta(microseconds=1)`.229230Обратите внимание, что из-за нормализации `timedelta.max` больше, чем `-timedelta.min`. `-timedelta.max` не представим как объект [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta).231232Атрибуты экземпляра (только для чтения):233234#### `timedelta.days`235236От -999,999,999 до 999,999,999 включительно.237238#### `timedelta.seconds`239240От 0 до 86,399 включительно.241242> **Внимание**243>244> Это довольно распространённая ошибка, когда код непреднамеренно использует этот атрибут, хотя на самом деле предполагается получить значение [`total_seconds()`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta.total_seconds) вместо этого:245>246> ```pycon247> >>> import datetime as dt248> >>> duration = dt.timedelta(seconds=11235813)249> >>> duration.days, duration.seconds250> (130, 3813)251> >>> duration.total_seconds()252> 11235813.0253> ```254255#### `timedelta.microseconds`256257От 0 до 999,999 включительно.258259Поддерживаемые операции:260261| Операция | Результат |262| --- | --- |263| `t1 = t2 + t3` | Сумма `t2` и `t3`. После этого `t1 - t2 == t3` и `t1 - t3 == t2` истинны. (1) |264| `t1 = t2 - t3` | Разность `t2` и `t3`. После этого `t1 == t2 - t3` и `t2 == t1 + t3` истинны. (1)(6) |265| `t1 = t2 * i or t1 = i * t2` | Дельта, умноженная на целое число. После этого `t1 // i == t2` истинно, при условии `i != 0`. |266|  | В общем случае `t1 * i == t1 * (i-1) + t1` истинно. (1) |267| `t1 = t2 * f or t1 = f * t2` | Дельта, умноженная на число с плавающей запятой. Результат округляется до ближайшего кратного timedelta.resolution по правилу round-half-to-even. |268| `f = t2 / t3` | Деление (3) общей длительности `t2` на единицу интервала `t3`. Возвращает объект [`float`](https://python-all.ru/3.13/library/functions.html#float). |269| `t1 = t2 / f or t1 = t2 / i` | Дельта, делённая на число с плавающей запятой или целое число. Результат округляется до ближайшего кратного timedelta.resolution по правилу round-half-to-even. |270| `t1 = t2 // i` или `t1 = t2 // t3` | Вычисляется целая часть, а остаток (если он есть) отбрасывается. Во втором случае возвращается целое число. (3) |271| `t1 = t2 % t3` | Остаток вычисляется как объект [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta). (3) |272| `q, r = divmod(t1, t2)` | Вычисляет частное и остаток: `q = t1 // t2` (3) и `r = t1 % t2`. `q` – целое число, а `r` – объект [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta). |273| `+t1` | Возвращает объект [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) с тем же значением. (2) |274| `-t1` | Эквивалентно `timedelta(-t1.days, -t1.seconds, -t1.microseconds)` и `t1 * -1`. (1)(4) |275| `abs(t)` | Эквивалентно `+t`, когда `t.days >= 0`, и `-t`, когда `t.days < 0`. (2) |276| `str(t)` | Возвращает строку вида `[D day[s], ][H]H:MM:SS[.UUUUUU]`, где D отрицательно для отрицательного `t`. (5) |277| `repr(t)` | Возвращает строковое представление объекта [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) в виде вызова конструктора с каноническими значениями атрибутов. |278279Примечания:2802811. Это точное, но может привести к переполнению.2822. Это точное и не может привести к переполнению.2833. Деление на ноль вызывает [`ZeroDivisionError`](https://python-all.ru/3.13/library/exceptions.html#ZeroDivisionError).2844. `-timedelta.max` не представимо в виде объекта [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta).2855. Строковые представления [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) объектов нормализуются аналогично их внутреннему представлению. Это приводит к несколько необычным результатам для отрицательных объектов timedelta. Например:286287   ```python288   >>> timedelta(hours=-5)289   datetime.timedelta(days=-1, seconds=68400)290   >>> print(_)291   -1 day, 19:00:00292   ```2936. Выражение `t2 - t3` всегда будет равно выражению `t2 + (-t3)`, за исключением случая, когда t3 равно `timedelta.max`; в этом случае первое выражение даст результат, а второе вызовет переполнение.294295В дополнение к перечисленным выше операциям, объекты [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) поддерживают некоторые операции сложения и вычитания с объектами [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date) и [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) (см. ниже).296297Изменено в версии 3.2: Теперь поддерживаются целочисленное деление и истинное деление объекта [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) на другой объект `timedelta`, а также операции взятия остатка и функция [`divmod()`](https://python-all.ru/3.13/library/functions.html#divmod). Также теперь поддерживаются истинное деление и умножение объекта `timedelta` на объект [`float`](https://python-all.ru/3.13/library/functions.html#float).298299Объекты [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) поддерживают сравнение на равенство и упорядочивание.300301В логических контекстах объект [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) считается истинным тогда и только тогда, когда он не равен `timedelta(0)`.302303Методы экземпляра:304305#### `timedelta.total_seconds()`306307Возвращает общее количество секунд, содержащихся в интервале. Эквивалентно `td / timedelta(seconds=1)`. Для единиц интервала, отличных от секунд, используйте форму деления напрямую (например, `td / timedelta(microseconds=1)`).308309Обратите внимание, что для очень больших временных интервалов (более 270 лет на большинстве платформ) этот метод теряет точность до микросекунд.310311Добавлено в версии 3.2.312313### Примеры использования: [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta)314315Дополнительный пример нормализации:316317```python318>>> # Компоненты another_year в сумме составляют ровно 365 дней319>>> import datetime as dt320>>> year = dt.timedelta(days=365)321>>> another_year = dt.timedelta(weeks=40, days=84, hours=23,322...                             minutes=50, seconds=600)323>>> year == another_year324True325>>> year.total_seconds()32631536000.0327```328329Примеры арифметики [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta):330331```python332>>> import datetime as dt333>>> year = dt.timedelta(days=365)334>>> ten_years = 10 * year335>>> ten_years336datetime.timedelta(days=3650)337>>> ten_years.days // 36533810339>>> nine_years = ten_years - year340>>> nine_years341datetime.timedelta(days=3285)342>>> three_years = nine_years // 3343>>> three_years, three_years.days // 365344(datetime.timedelta(days=1095), 3)345```346347## [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date) Объекты348349Объект [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date) представляет дату (год, месяц и день) в идеализированном календаре – текущем григорианском календаре, бесконечно расширенном в обе стороны.3503511 января 1 года называется днём номер 1, 2 января 1 года – днём номер 2 и так далее. [\[2\]](https://python-all.ru/3.13/library/datetime.html#id5)352353#### `class datetime.date(year, month, day)`354355Все аргументы обязательны. Аргументы должны быть целыми числами в следующих диапазонах:356357- `MINYEAR <= year <= MAXYEAR`358- `1 <= month <= 12`359- `1 <= day <= number of days in the given month and year`360361Если указан аргумент вне этих диапазонов, возбуждается [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError).362363Другие конструкторы – все методы класса:364365#### `classmethod date.today()`366367Возвращает текущую локальную дату.368369Это эквивалентно `date.fromtimestamp(time.time())`.370371#### `classmethod date.fromtimestamp(timestamp)`372373Возвращает локальную дату, соответствующую метке времени POSIX, такую, как возвращает функция [`time.time()`](https://python-all.ru/3.13/library/time.html#time.time).374375Это может вызвать [`OverflowError`](https://python-all.ru/3.13/library/exceptions.html#OverflowError), если метка времени находится за пределами диапазона значений, поддерживаемого функцией C `localtime()` платформы, и [`OSError`](https://python-all.ru/3.13/library/exceptions.html#OSError) при ошибке `localtime()`. Обычно это ограничивается годами с 1970 по 2038. Обратите внимание, что в системах, не соответствующих POSIX, которые включают високосные секунды в своё представление метки времени, високосные секунды игнорируются функцией `fromtimestamp()`.376377Изменено в версии 3.3: Вызывает [`OverflowError`](https://python-all.ru/3.13/library/exceptions.html#OverflowError) вместо [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError), если метка времени выходит за пределы диапазона значений, поддерживаемого функцией `localtime()` платформы C. Вызывает [`OSError`](https://python-all.ru/3.13/library/exceptions.html#OSError) вместо `ValueError` при ошибке `localtime()`.378379#### `classmethod date.fromordinal(ordinal)`380381Возвращает дату, соответствующую пролептическому григорианскому порядковому номеру, где 1 января 1 года имеет порядковый номер 1.382383[`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError) вызывается, если только `1 <= ordinal <= date.max.toordinal()`. Для любой даты `d`, `date.fromordinal(d.toordinal()) == d`.384385#### `classmethod date.fromisoformat(date_string)`386387Возвращает [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date), соответствующий *date\_string*, заданной в любом допустимом формате ISO 8601, за следующими исключениями:3883891. Даты с пониженной точностью в настоящее время не поддерживаются (`YYYY-MM`, `YYYY`).3902. Расширенные представления дат в настоящее время не поддерживаются (`±YYYYYY-MM-DD`).3913. Порядковые даты в настоящее время не поддерживаются (`YYYY-OOO`).392393Примеры:394395```python396>>> import datetime as dt397>>> dt.date.fromisoformat('2019-12-04')398datetime.date(2019, 12, 4)399>>> dt.date.fromisoformat('20191204')400datetime.date(2019, 12, 4)401>>> dt.date.fromisoformat('2021-W01-1')402datetime.date(2021, 1, 4)403```404405Добавлено в версии 3.7.406407Изменено в версии 3.11: Ранее этот метод поддерживал только формат `YYYY-MM-DD`.408409#### `classmethod date.fromisocalendar(year, week, day)`410411Возвращает [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date), соответствующий дате по календарю ISO, заданной годом, неделей и днём. Это обратная функция для [`date.isocalendar()`](https://python-all.ru/3.13/library/datetime.html#datetime.date.isocalendar).412413Добавлено в версии 3.8.414415Атрибуты класса:416417#### `date.min`418419Самая ранняя представимая дата, `date(MINYEAR, 1, 1)`.420421#### `date.max`422423Самая поздняя представимая дата, `date(MAXYEAR, 12, 31)`.424425#### `date.resolution`426427Наименьшая возможная разница между неравными объектами дат, `timedelta(days=1)`.428429Атрибуты экземпляра (только для чтения):430431#### `date.year`432433От [`MINYEAR`](https://python-all.ru/3.13/library/datetime.html#datetime.MINYEAR) до [`MAXYEAR`](https://python-all.ru/3.13/library/datetime.html#datetime.MAXYEAR) включительно.434435#### `date.month`436437От 1 до 12 включительно.438439#### `date.day`440441От 1 до количества дней в указанном месяце указанного года.442443Поддерживаемые операции:444445| Операция | Результат |446| --- | --- |447| `date2 = date1 + timedelta` | `date2` будет на `timedelta.days` дней позже `date1`. (1) |448| `date2 = date1 - timedelta` | Вычисляет `date2` так, что `date2 + timedelta == date1`. (2) |449| `timedelta = date1 - date2` | (3) |450| `date1 == date2` `date1 != date2` | Сравнение на равенство. (4) |451| `date1 < date2` `date1 > date2` `date1 <= date2` `date1 >= date2` | Сравнение порядка. (5) |452453Примечания:4544551. *date2* сдвигается вперёд во времени, если `timedelta.days > 0`, или назад, если `timedelta.days < 0`. После этого `date2 - date1 == timedelta.days`. `timedelta.seconds` и `timedelta.microseconds` игнорируются. [`OverflowError`](https://python-all.ru/3.13/library/exceptions.html#OverflowError) возбуждается, если `date2.year` оказался бы меньше, чем [`MINYEAR`](https://python-all.ru/3.13/library/datetime.html#datetime.MINYEAR), или больше, чем [`MAXYEAR`](https://python-all.ru/3.13/library/datetime.html#datetime.MAXYEAR).4562. `timedelta.seconds` и `timedelta.microseconds` игнорируются.4573. Это точная операция и не может вызвать переполнение. `timedelta.seconds` и `timedelta.microseconds` равны 0, а `date2 + timedelta == date1` после.4584. Объекты [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date) равны, если они представляют одну и ту же дату.459460   Объекты `date`, не являющиеся также экземплярами [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime), никогда не равны объектам `datetime`, даже если они представляют одну и ту же дату.4615. *date1* считается меньше *date2*, когда *date1* предшествует *date2* во времени. Другими словами, `date1 < date2` тогда и только тогда, когда `date1.toordinal() < date2.toordinal()`.462463   Сравнение порядка между объектом [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date), не являющимся также экземпляром [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime), и объектом `datetime` возбуждает [`TypeError`](https://python-all.ru/3.13/library/exceptions.html#TypeError).464465Изменено в версии 3.13: Сравнение между объектом [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) и экземпляром подкласса [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date), который не является подклассом `datetime`, больше не преобразует последний в `date`, игнорируя временную часть и часовой пояс. Поведение по умолчанию можно изменить, переопределив специальные методы сравнения в подклассах.466467В булевом контексте все объекты [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date) считаются истинными.468469Методы экземпляра:470471#### `date.replace(year=self.year, month=self.month, day=self.day)`472473Возвращает новый объект [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date) с теми же значениями, но с обновлёнными указанными параметрами.474475Пример:476477```python478>>> import datetime as dt479>>> d = dt.date(2002, 12, 31)480>>> d.replace(day=26)481datetime.date(2002, 12, 26)482```483484Универсальная функция [`copy.replace()`](https://python-all.ru/3.13/library/copy.html#copy.replace) также поддерживает объекты [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date).485486#### `date.timetuple()`487488Возвращает [`time.struct_time`](https://python-all.ru/3.13/library/time.html#time.struct_time) такой, какой возвращается [`time.localtime()`](https://python-all.ru/3.13/library/time.html#time.localtime).489490Часы, минуты и секунды равны 0, а флаг DST равен -1.491492`d.timetuple()` эквивалентно:493494```python495time.struct_time((d.year, d.month, d.day, 0, 0, 0, d.weekday(), yday, -1))496```497498где `yday = d.toordinal() - date(d.year, 1, 1).toordinal() + 1` – это номер дня в текущем году, начиная с 1 для 1 января.499500#### `date.toordinal()`501502Возвращает пролептический григорианский порядковый номер даты, где 1 января 1 года имеет порядковый номер 1. Для любого объекта [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date) `d`, `date.fromordinal(d.toordinal()) == d`.503504#### `date.weekday()`505506Возвращает день недели в виде целого числа, где понедельник – 0, а воскресенье – 6. Например, `date(2002, 12, 4).weekday() == 2`, среда. См. также [`isoweekday()`](https://python-all.ru/3.13/library/datetime.html#datetime.date.isoweekday).507508#### `date.isoweekday()`509510Возвращает день недели в виде целого числа, где понедельник – 1, а воскресенье – 7. Например, `date(2002, 12, 4).isoweekday() == 3`, среда. См. также [`weekday()`](https://python-all.ru/3.13/library/datetime.html#datetime.date.weekday), [`isocalendar()`](https://python-all.ru/3.13/library/datetime.html#datetime.date.isocalendar).511512#### `date.isocalendar()`513514Возвращает объект [именованный кортеж](https://python-all.ru/3.13/glossary.html#term-named-tuple) с тремя компонентами: `year`, `week` и `weekday`.515516Календарь ISO – широко используемый вариант григорианского календаря. [\[3\]](https://python-all.ru/3.13/library/datetime.html#id6)517518Год ISO состоит из 52 или 53 полных недель, причём неделя начинается в понедельник и заканчивается в воскресенье. Первая неделя года ISO – это первая (григорианская) календарная неделя года, в которую входит четверг. Она называется неделей номер 1, и год ISO этого четверга совпадает с его григорианским годом.519520Например, 2004 год начинается в четверг, поэтому первая неделя года ISO 2004 начинается в понедельник, 29 декабря 2003 г., и заканчивается в воскресенье, 4 января 2004 г.:521522```python523>>> import datetime as dt524>>> dt.date(2003, 12, 29).isocalendar()525datetime.IsoCalendarDate(year=2004, week=1, weekday=1)526>>> dt.date(2004, 1, 4).isocalendar()527datetime.IsoCalendarDate(year=2004, week=1, weekday=7)528```529530Изменено в версии 3.9: Результат изменён с кортежа на [именованный кортеж](https://python-all.ru/3.13/glossary.html#term-named-tuple).531532#### `date.isoformat()`533534Возвращает строку, представляющую дату в формате ISO 8601, `YYYY-MM-DD`:535536```python537>>> import datetime as dt538>>> dt.date(2002, 12, 4).isoformat()539'2002-12-04'540```541542#### `date.__str__()`543544Для даты `d` `str(d)` эквивалентно `d.isoformat()`.545546#### `date.ctime()`547548Возвращает строку, представляющую дату:549550```python551>>> import datetime as dt552>>> dt.date(2002, 12, 4).ctime()553'Wed Dec  4 00:00:00 2002'554```555556`d.ctime()` эквивалентно:557558```python559time.ctime(time.mktime(d.timetuple()))560```561562на платформах, где нативная функция C `ctime()` (которую вызывает [`time.ctime()`](https://python-all.ru/3.13/library/time.html#time.ctime), но которую `date.ctime()` не вызывает) соответствует стандарту C.563564#### `date.strftime(format)`565566Возвращает строку с датой, форматированную по явной строке формата. Коды формата, соответствующие часам, минутам или секундам, будут принимать нулевые значения. См. также [strftime() and strptime() Behavior](https://python-all.ru/3.13/library/datetime.html#strftime-strptime-behavior) и [`date.isoformat()`](https://python-all.ru/3.13/library/datetime.html#datetime.date.isoformat).567568#### `date.__format__(format)`569570То же, что [`date.strftime()`](https://python-all.ru/3.13/library/datetime.html#datetime.date.strftime). Позволяет задать строку формата для объекта [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date) в [f-строках](https://python-all.ru/3.13/reference/lexical_analysis.html#f-strings) и при использовании [`str.format()`](https://python-all.ru/3.13/library/stdtypes.html#str.format). См. также [strftime() and strptime() Behavior](https://python-all.ru/3.13/library/datetime.html#strftime-strptime-behavior) и [`date.isoformat()`](https://python-all.ru/3.13/library/datetime.html#datetime.date.isoformat).571572### Примеры использования: [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date)573574Пример подсчёта дней до события:575576```python577>>> import time578>>> import datetime as dt579>>> today = dt.date.today()580>>> today581datetime.date(2007, 12, 5)582>>> today == dt.date.fromtimestamp(time.time())583True584>>> my_birthday = dt.date(today.year, 6, 24)585>>> if my_birthday < today:586...     my_birthday = my_birthday.replace(year=today.year + 1)587...588>>> my_birthday589datetime.date(2008, 6, 24)590>>> time_to_birthday = abs(my_birthday - today)591>>> time_to_birthday.days592202593```594595Другие примеры работы с [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date):596597```pycon598>>> import datetime as dt599>>> d = dt.date.fromordinal(730920) # 730920-й день после 1.1.0001600>>> d601datetime.date(2002, 3, 11)602603>>> # Методы, связанные с форматированием строкового вывода604>>> d.isoformat()605'2002-03-11'606>>> d.strftime("%d/%m/%y")607'11/03/02'608>>> d.strftime("%A %d. %B %Y")609'Monday 11. March 2002'610>>> d.ctime()611'Mon Mar 11 00:00:00 2002'612>>> 'The {1} is {0:%d}, the {2} is {0:%B}.'.format(d, "day", "month")613'The day is 11, the month is March.'614615>>> # Методы для извлечения 'компонентов' в разных календарях616>>> t = d.timetuple()617>>> for i in t:618...     print(i)6192002                # year6203                   # month62111                  # day6220623062406250                   # weekday (0 = Monday)62670                  # 70th day in the year627-1628>>> ic = d.isocalendar()629>>> for i in ic:630...     print(i)6312002                # ISO year63211                  # ISO week number6331                   # ISO day number ( 1 = Monday )634635>>> # Объект date является неизменяемым; все операции создают новый объект636>>> d.replace(year=2005)637datetime.date(2005, 3, 11)638```639640## [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) Объекты641642Объект [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) – это единый объект, содержащий всю информацию из объекта [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date) и объекта [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time).643644Как и объект [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date), [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) предполагает текущий григорианский календарь, расширенный в обе стороны; как и объект [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time), `datetime` предполагает, что в каждом дне ровно 3600\*24 секунд.645646Конструктор:647648#### `class datetime.datetime(year, month, day, hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)`649650Аргументы *year*, *month* и *day* обязательны. *tzinfo* может быть `None` или экземпляром подкласса [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo). Остальные аргументы должны быть целыми числами в следующих диапазонах:651652- `MINYEAR <= year <= MAXYEAR`,653- `1 <= month <= 12`,654- `1 <= day <= number of days in the given month and year`,655- `0 <= hour < 24`,656- `0 <= minute < 60`,657- `0 <= second < 60`,658- `0 <= microsecond < 1000000`,659- `fold in [0, 1]`.660661Если указан аргумент вне этих диапазонов, возбуждается [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError).662663Изменено в версии 3.6: Добавлен параметр *fold*.664665Другие конструкторы – все методы класса:666667#### `classmethod datetime.today()`668669Возвращает текущие локальные дату и время, с [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo) `None`.670671Эквивалентно следующему:672673```python674datetime.fromtimestamp(time.time())675```676677См. также [`now()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.now), [`fromtimestamp()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.fromtimestamp).678679Этот метод функционально эквивалентен [`now()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.now), но без параметра `tz`.680681#### `classmethod datetime.now(tz=None)`682683Возвращает текущие локальные дату и время.684685Если необязательный аргумент *tz* равен `None` или не указан, это аналогично [`today()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.today), но, по возможности, обеспечивает большую точность, чем можно получить через метку времени [`time.time()`](https://python-all.ru/3.13/library/time.html#time.time) (например, это возможно на платформах, предоставляющих функцию C `gettimeofday()`).686687Если *tz* не равен `None`, он должен быть экземпляром подкласса [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo), а текущие дата и время преобразуются в часовой пояс *tz*.688689Эта функция предпочтительнее [`today()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.today) и [`utcnow()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.utcnow).690691> **Примечание**692>693> Последующие вызовы `datetime.now()` могут возвращать один и тот же момент времени в зависимости от точности базовых часов.694695#### `classmethod datetime.utcnow()`696697Возвращает текущие дату и время UTC, с [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo) `None`.698699Это похоже на [`now()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.now), но возвращает текущие дату и время UTC в виде наивного объекта [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime). Осведомлённый объект текущего времени UTC можно получить, вызвав `datetime.now(timezone.utc)`. См. также `now()`.700701> **Предупреждение**702>703> Поскольку наивные объекты `datetime` многими методами `datetime` рассматриваются как местное время, для представления времени в UTC предпочтительнее использовать осведомлённые объекты datetime. Поэтому рекомендуемый способ создания объекта, представляющего текущее время в UTC, – вызов `datetime.now(timezone.utc)`.704705Устарело с версии 3.12: Вместо этого используйте [`datetime.now()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.now) с [`UTC`](https://python-all.ru/3.13/library/datetime.html#datetime.UTC).706707#### `classmethod datetime.fromtimestamp(timestamp, tz=None)`708709Возвращает локальные дату и время, соответствующие метке времени POSIX, такой как возвращается [`time.time()`](https://python-all.ru/3.13/library/time.html#time.time). Если необязательный аргумент *tz* равен `None` или не указан, метка времени преобразуется в локальные дату и время платформы, и возвращаемый объект [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) является наивным.710711Если *tz* не равен `None`, он должен быть экземпляром подкласса [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo), и метка времени преобразуется в часовой пояс *tz*.712713`fromtimestamp()` может возбуждать [`OverflowError`](https://python-all.ru/3.13/library/exceptions.html#OverflowError), если метка времени выходит за диапазон значений, поддерживаемых платформенными функциями C `localtime()` или `gmtime()`, и [`OSError`](https://python-all.ru/3.13/library/exceptions.html#OSError) при ошибке `localtime()` или `gmtime()`. Обычно это ограничено годами с 1970 по 2038. Обратите внимание, что на системах, не совместимых с POSIX, которые включают високосные секунды в своё представление метки времени, високосные секунды игнорируются `fromtimestamp()`, и поэтому возможно иметь две метки времени, различающиеся на секунду, которые дают идентичные объекты [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime). Этот метод предпочтительнее [`utcfromtimestamp()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.utcfromtimestamp).714715Изменено в версии 3.3: Возбуждает [`OverflowError`](https://python-all.ru/3.13/library/exceptions.html#OverflowError) вместо [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError), если метка времени выходит за диапазон значений, поддерживаемых платформенными функциями C `localtime()` или `gmtime()`. Возбуждает [`OSError`](https://python-all.ru/3.13/library/exceptions.html#OSError) вместо `ValueError` при ошибке `localtime()` или `gmtime()`.716717Изменено в версии 3.6: `fromtimestamp()` может возвращать экземпляры с [`fold`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.fold), установленным в 1.718719#### `classmethod datetime.utcfromtimestamp(timestamp)`720721Возвращает [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) UTC, соответствующий метке времени POSIX, с [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo) `None`. (Результирующий объект является наивным.)722723Это может возбуждать [`OverflowError`](https://python-all.ru/3.13/library/exceptions.html#OverflowError), если метка времени выходит за диапазон значений, поддерживаемых платформенной функцией C `gmtime()`, и [`OSError`](https://python-all.ru/3.13/library/exceptions.html#OSError) при ошибке `gmtime()`. Обычно это ограничено годами с 1970 по 2038.724725Чтобы получить осведомлённый объект [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime), вызовите [`fromtimestamp()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.fromtimestamp):726727```python728datetime.fromtimestamp(timestamp, timezone.utc)729```730731На платформах, совместимых с POSIX, это эквивалентно следующему выражению:732733```python734datetime(1970, 1, 1, tzinfo=timezone.utc) + timedelta(seconds=timestamp)735```736737за исключением того, что последняя формула всегда поддерживает полный диапазон лет: от [`MINYEAR`](https://python-all.ru/3.13/library/datetime.html#datetime.MINYEAR) до [`MAXYEAR`](https://python-all.ru/3.13/library/datetime.html#datetime.MAXYEAR) включительно.738739> **Предупреждение**740>741> Поскольку наивные объекты `datetime` во многих методах `datetime` трактуются как местное время, для представления времени в UTC предпочтительнее использовать aware-даты. Поэтому рекомендуемый способ создания объекта для конкретной метки времени в UTC – вызов `datetime.fromtimestamp(timestamp, tz=timezone.utc)`.742743Изменено в версии 3.3: Вызывает [`OverflowError`](https://python-all.ru/3.13/library/exceptions.html#OverflowError) вместо [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError), если метка времени выходит за пределы диапазона значений, поддерживаемого функцией `gmtime()` платформы C. Вызывает [`OSError`](https://python-all.ru/3.13/library/exceptions.html#OSError) вместо `ValueError` при ошибке `gmtime()`.744745Устарело с версии 3.12: Вместо этого используйте [`datetime.fromtimestamp()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.fromtimestamp) с [`UTC`](https://python-all.ru/3.13/library/datetime.html#datetime.UTC).746747#### `classmethod datetime.fromordinal(ordinal)`748749Возвращает [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime), соответствующий пролептическому григорианскому порядковому номеру, где 1 января 1 года имеет порядковый номер 1. [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError) вызывается, если не выполнено `1 <= ordinal <= datetime.max.toordinal()`. Час, минута, секунда и микросекунда результата равны 0, а [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo) равен `None`.750751#### `classmethod datetime.combine(date, time, tzinfo=time.tzinfo)`752753Возвращает новый объект [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime), компоненты даты которого равны компонентам заданного объекта [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date), а компоненты времени равны компонентам заданного объекта [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time). Если указан аргумент *tzinfo*, его значение используется для установки атрибута [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo) результата, в противном случае используется атрибут [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.time.tzinfo) аргумента *time*. Если аргумент *date* является объектом `datetime`, его компоненты времени и атрибуты `tzinfo` игнорируются.754755Для любого объекта [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) `d`, `d == datetime.combine(d.date(), d.time(), d.tzinfo)`.756757Изменено в версии 3.6: Добавлен аргумент *tzinfo*.758759#### `classmethod datetime.fromisoformat(date_string)`760761Возвращает [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime), соответствующий строке *date\_string* в любом допустимом формате ISO 8601, за следующими исключениями:7627631. Смещения часовых поясов могут содержать доли секунды.7642. Разделитель `T` может быть заменён любым отдельным символом Unicode.7653. Доли часов и минут не поддерживаются.7664. Даты с пониженной точностью в настоящее время не поддерживаются (`YYYY-MM`, `YYYY`).7675. Расширенные представления дат в настоящее время не поддерживаются (`±YYYYYY-MM-DD`).7686. Порядковые даты в настоящее время не поддерживаются (`YYYY-OOO`).769770Примеры:771772```python773>>> import datetime as dt774>>> dt.datetime.fromisoformat('2011-11-04')775datetime.datetime(2011, 11, 4, 0, 0)776>>> dt.datetime.fromisoformat('20111104')777datetime.datetime(2011, 11, 4, 0, 0)778>>> dt.datetime.fromisoformat('2011-11-04T00:05:23')779datetime.datetime(2011, 11, 4, 0, 5, 23)780>>> dt.datetime.fromisoformat('2011-11-04T00:05:23Z')781datetime.datetime(2011, 11, 4, 0, 5, 23, tzinfo=datetime.timezone.utc)782>>> dt.datetime.fromisoformat('20111104T000523')783datetime.datetime(2011, 11, 4, 0, 5, 23)784>>> dt.datetime.fromisoformat('2011-W01-2T00:05:23.283')785datetime.datetime(2011, 1, 4, 0, 5, 23, 283000)786>>> dt.datetime.fromisoformat('2011-11-04 00:05:23.283')787datetime.datetime(2011, 11, 4, 0, 5, 23, 283000)788>>> dt.datetime.fromisoformat('2011-11-04 00:05:23.283+00:00')789datetime.datetime(2011, 11, 4, 0, 5, 23, 283000, tzinfo=datetime.timezone.utc)790>>> dt.datetime.fromisoformat('2011-11-04T00:05:23+04:00')791datetime.datetime(2011, 11, 4, 0, 5, 23,792    tzinfo=datetime.timezone(datetime.timedelta(seconds=14400)))793```794795Добавлено в версии 3.7.796797Изменено в версии 3.11: Ранее этот метод поддерживал только форматы, которые могли быть созданы с помощью [`date.isoformat()`](https://python-all.ru/3.13/library/datetime.html#datetime.date.isoformat) или [`datetime.isoformat()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.isoformat).798799#### `classmethod datetime.fromisocalendar(year, week, day)`800801Возвращает [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime), соответствующий дате по ISO-календарю, заданной годом, неделей и днём. Компоненты datetime, не относящиеся к дате, заполняются обычными значениями по умолчанию. Это обратная функция для [`datetime.isocalendar()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.isocalendar).802803Добавлено в версии 3.8.804805#### `classmethod datetime.strptime(date_string, format)`806807Возвращает объект [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime), соответствующий *date\_string*, разобранный в соответствии с *format*.808809Если *format* не содержит микросекунд или информации о часовом поясе, это эквивалентно:810811```python812datetime(*(time.strptime(date_string, format)[0:6]))813```814815[`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError) возбуждается, если date\_string и format не удаётся разобрать с помощью [`time.strptime()`](https://python-all.ru/3.13/library/time.html#time.strptime), или если возвращается значение, не являющееся кортежем времени. См. также [strftime() and strptime() Behavior](https://python-all.ru/3.13/library/datetime.html#strftime-strptime-behavior) и [`datetime.fromisoformat()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.fromisoformat).816817Изменено в версии 3.13: Если в *format* указан день месяца без года, теперь выдаётся [`DeprecationWarning`](https://python-all.ru/3.13/library/exceptions.html#DeprecationWarning). Это необходимо для избежания четырёхлетней ошибки, связанной с високосным годом, в коде, который пытается разобрать только месяц и день, поскольку год по умолчанию, используемый при отсутствии года в формате, не является високосным. Такие значения *format* могут вызывать ошибку начиная с Python 3.15. Решение – всегда включать год в *format*. При разборе значений *date\_string*, не содержащих года, перед разбором явно добавьте год, который является високосным:818819```pycon820>>> import datetime as dt821>>> date_string = "02/29"822>>> when = dt.datetime.strptime(f"{date_string};1984", "%m/%d;%Y")  # Избегает ошибки високосного года.823>>> when.strftime("%B %d")824'February 29'825```826827Атрибуты класса:828829#### `datetime.min`830831Самое раннее представимое [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime), `datetime(MINYEAR, 1, 1, tzinfo=None)`.832833#### `datetime.max`834835Самое позднее представимое [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime), `datetime(MAXYEAR, 12, 31, 23, 59, 59, 999999, tzinfo=None)`.836837#### `datetime.resolution`838839Наименьшая возможная разница между неравными [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) объектами, `timedelta(microseconds=1)`.840841Атрибуты экземпляра (только для чтения):842843#### `datetime.year`844845От [`MINYEAR`](https://python-all.ru/3.13/library/datetime.html#datetime.MINYEAR) до [`MAXYEAR`](https://python-all.ru/3.13/library/datetime.html#datetime.MAXYEAR) включительно.846847#### `datetime.month`848849От 1 до 12 включительно.850851#### `datetime.day`852853От 1 до количества дней в указанном месяце указанного года.854855#### `datetime.hour`856857В `range(24)`.858859#### `datetime.minute`860861В `range(60)`.862863#### `datetime.second`864865В `range(60)`.866867#### `datetime.microsecond`868869В `range(1000000)`.870871#### `datetime.tzinfo`872873Объект, переданный в качестве аргумента *tzinfo* конструктору [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime), или `None`, если ничего не было передано.874875#### `datetime.fold`876877В `[0, 1]`. Используется для устранения неоднозначности поясного времени в повторяющемся интервале. (Повторяющийся интервал возникает, когда часы переводятся назад в конце перехода на летнее время или когда смещение UTC для текущего часового пояса уменьшается по политическим причинам.) Значения 0 и 1 представляют соответственно более ранний и более поздний из двух моментов с одинаковым представлением поясного времени.878879Добавлено в версии 3.6.880881Поддерживаемые операции:882883| Операция | Результат |884| --- | --- |885| `datetime2 = datetime1 + timedelta` | (1) |886| `datetime2 = datetime1 - timedelta` | (2) |887| `timedelta = datetime1 - datetime2` | (3) |888| `datetime1 == datetime2` `datetime1 != datetime2` | Сравнение на равенство. (4) |889| `datetime1 < datetime2` `datetime1 > datetime2` `datetime1 <= datetime2` `datetime1 >= datetime2` | Сравнение порядка. (5) |8908911. `datetime2` – это длительность `timedelta`, вычитаемая из `datetime1`, сдвигающая время вперёд, если `timedelta.days > 0`, или назад, если `timedelta.days < 0`. Результат имеет тот же атрибут [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo), что и исходный datetime, и `datetime2 - datetime1 == timedelta` после. [`OverflowError`](https://python-all.ru/3.13/library/exceptions.html#OverflowError) возникает, если `datetime2.year` окажется меньше [`MINYEAR`](https://python-all.ru/3.13/library/datetime.html#datetime.MINYEAR) или больше [`MAXYEAR`](https://python-all.ru/3.13/library/datetime.html#datetime.MAXYEAR). Обратите внимание, что корректировка часового пояса не выполняется, даже если исходный объект осведомлён.8922. Вычисляет `datetime2`, такой что `datetime2 + timedelta == datetime1`. Как и при сложении, результат имеет тот же атрибут [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo), что и исходный datetime, и корректировка часового пояса не выполняется, даже если исходный объект осведомлён.8933. Вычитание [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) из `datetime` определено только если оба операнда наивны или оба осведомлены. Если один осведомлён, а другой наивен, возникает [`TypeError`](https://python-all.ru/3.13/library/exceptions.html#TypeError).894895   Если оба наивны, или оба осведомлены и имеют одинаковый атрибут [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo), атрибуты `tzinfo` игнорируются, и результатом является объект [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) `t`, такой что `datetime2 + t == datetime1`. В этом случае корректировка часового пояса не выполняется.896897   Если оба осведомлены и имеют разные атрибуты [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo), `a-b` действует так, как если бы `a` и `b` были сначала преобразованы в наивные объекты datetime в UTC. Результат – `(a.replace(tzinfo=None) - a.utcoffset()) - (b.replace(tzinfo=None) - b.utcoffset())`, за исключением того, что в реализации никогда не возникает переполнения.8984. Объекты [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) равны, если они представляют одну и ту же дату и время с учётом часового пояса.899900   Наивные и осознающие объекты [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) никогда не равны.901902   Если оба операнда осознающие и имеют одинаковый атрибут `tzinfo`, атрибуты `tzinfo` и [`fold`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.fold) игнорируются, и сравниваются базовые даты и время. Если оба операнда осознающие и имеют разные атрибуты [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo), сравнение ведётся так, как если бы операнды сначала были преобразованы в даты и время в UTC, за исключением того, что реализация никогда не вызывает переполнение. Экземпляры [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) в повторяющемся интервале никогда не равны экземплярам `datetime` в другом часовом поясе.9035. *datetime1* считается меньше *datetime2*, когда *datetime1* предшествует *datetime2* во времени с учётом часового пояса.904905   Операция сравнения порядка между наивными и осознающими объектами [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) вызывает [`TypeError`](https://python-all.ru/3.13/library/exceptions.html#TypeError).906907   Если оба операнда осознающие и имеют одинаковый атрибут `tzinfo`, атрибуты `tzinfo` и [`fold`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.fold) игнорируются, и сравниваются базовые даты и время. Если оба операнда осознающие и имеют разные атрибуты [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo), сравнение ведётся так, как если бы операнды сначала были преобразованы в даты и время в UTC, за исключением того, что реализация никогда не вызывает переполнение.908909Изменено в версии 3.3: Сравнения на равенство между осознающими и наивными экземплярами [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) не вызывают [`TypeError`](https://python-all.ru/3.13/library/exceptions.html#TypeError).910911Изменено в версии 3.13: Сравнение между объектом [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) и экземпляром подкласса [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date), который не является подклассом `datetime`, больше не преобразует последний в `date`, игнорируя временную часть и часовой пояс. Поведение по умолчанию можно изменить, переопределив специальные методы сравнения в подклассах.912913Методы экземпляра:914915#### `datetime.date()`916917Возвращает объект [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date) с тем же годом, месяцем и днём.918919#### `datetime.time()`920921Возвращает объект [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) с теми же часами, минутами, секундами, микросекундами и fold. [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo) равно `None`. См. также метод [`timetz()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.timetz).922923Изменено в версии 3.6: Значение fold копируется в возвращаемый объект [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time).924925#### `datetime.timetz()`926927Возвращает объект [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) с теми же атрибутами hour, minute, second, microsecond, fold и tzinfo. См. также метод [`time()`](https://python-all.ru/3.13/library/time.html#module-time).928929Изменено в версии 3.6: Значение fold копируется в возвращаемый объект [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time).930931#### `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)`932933Возвращает новый объект [`datetime`](https://python-all.ru/3.13/library/datetime.html#module-datetime) с теми же атрибутами, но с обновлёнными указанными параметрами. Обратите внимание, что `tzinfo=None` можно указать, чтобы создать наивный datetime из осознающего без преобразования данных даты и времени.934935Объекты [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) также поддерживаются обобщённой функцией [`copy.replace()`](https://python-all.ru/3.13/library/copy.html#copy.replace).936937Изменено в версии 3.6: Добавлен параметр *fold*.938939#### `datetime.astimezone(tz=None)`940941Возвращает объект [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) с новым атрибутом [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo) *tz*, корректируя данные даты и времени так, чтобы результат соответствовал тому же времени UTC, что и *self*, но в местном времени *tz*.942943Если *tz* указан, он должен быть экземпляром подкласса [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo), а его методы [`utcoffset()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.utcoffset) и [`dst()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.dst) не должны возвращать `None`. Если *self* наивный, предполагается, что он представляет время в системном часовом поясе.944945Если вызывается без аргументов (или с `tz=None`), для целевого часового пояса используется системный местный часовой пояс. Атрибут `.tzinfo` преобразованного экземпляра datetime будет установлен в экземпляр [`timezone`](https://python-all.ru/3.13/library/datetime.html#datetime.timezone) с именем зоны и смещением, полученными от ОС.946947Если `self.tzinfo` равно *tz*, `self.astimezone(tz)` равно *self*: корректировка данных даты или времени не выполняется. В противном случае результат – местное время в часовом поясе *tz*, представляющее то же время UTC, что и *self*: после `astz = dt.astimezone(tz)` `astz - astz.utcoffset()` будут содержать те же данные даты и времени, что и `dt - dt.utcoffset()`.948949Если нужно просто прикрепить объект [`timezone`](https://python-all.ru/3.13/library/datetime.html#datetime.timezone) *tz* к datetime *dt* без корректировки данных даты и времени, используйте `dt.replace(tzinfo=tz)`. Если нужно просто удалить объект `timezone` из осознающего datetime *dt* без преобразования данных даты и времени, используйте `dt.replace(tzinfo=None)`.950951Обратите внимание, что метод по умолчанию [`tzinfo.fromutc()`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo.fromutc) можно переопределить в подклассе [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo), чтобы повлиять на результат, возвращаемый `astimezone()`. Если не учитывать ошибки, `astimezone()` работает следующим образом:952953```python954def astimezone(self, tz):955    if self.tzinfo is tz:956        return self957    # Преобразует self в UTC и присоединяет новый объект часового пояса.958    utc = (self - self.utcoffset()).replace(tzinfo=tz)959    # Преобразует из UTC в местное время tz.960    return tz.fromutc(utc)961```962963Изменено в версии 3.3: *tz* теперь можно опускать.964965Изменено в версии 3.6: Метод `astimezone()` теперь можно вызывать для наивных экземпляров, которые считаются представляющими системное местное время.966967#### `datetime.utcoffset()`968969Если [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo) равно `None`, возвращает `None`, иначе возвращает `self.tzinfo.utcoffset(self)`, и возбуждает исключение, если последнее не возвращает `None` или объект [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) с величиной менее одного дня.970971Изменено в версии 3.7: Смещение UTC теперь не ограничено целым числом минут.972973#### `datetime.dst()`974975Если [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo) равно `None`, возвращается `None`, иначе возвращается `self.tzinfo.dst(self)`, и возбуждается исключение, если последний не возвращает `None` или объект [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) с величиной меньше одного дня.976977Изменено в версии 3.7: Смещение DST не ограничивается целым числом минут.978979#### `datetime.tzname()`980981Если [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo) равно `None`, возвращается `None`, иначе возвращается `self.tzinfo.tzname(self)`, возбуждается исключение, если последний не возвращает `None` или строковый объект,982983#### `datetime.timetuple()`984985Возвращает [`time.struct_time`](https://python-all.ru/3.13/library/time.html#time.struct_time) такой, какой возвращается [`time.localtime()`](https://python-all.ru/3.13/library/time.html#time.localtime).986987`d.timetuple()` эквивалентно:988989```python990time.struct_time((d.year, d.month, d.day,991                  d.hour, d.minute, d.second,992                  d.weekday(), yday, dst))993```994995где `yday = d.toordinal() - date(d.year, 1, 1).toordinal() + 1` – номер дня в текущем году, начиная с 1 для 1 января. Флаг [`tm_isdst`](https://python-all.ru/3.13/library/time.html#time.struct_time.tm_isdst) результата устанавливается в соответствии с методом [`dst()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.dst): если [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo) равно `None` или `dst()` возвращает `None`, `tm_isdst` устанавливается в `-1`; иначе, если `dst()` возвращает ненулевое значение, `tm_isdst` устанавливается в 1; иначе `tm_isdst` устанавливается в 0.996997#### `datetime.utctimetuple()`998999Если экземпляр [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) `d` наивный, это то же самое, что `d.timetuple()`, за исключением того, что [`tm_isdst`](https://python-all.ru/3.13/library/time.html#time.struct_time.tm_isdst) принудительно устанавливается в 0 независимо от того, что возвращает `d.dst()`. DST никогда не действует для времени UTC.10001001Если `d` осознанный, `d` нормализуется к времени UTC вычитанием `d.utcoffset()`, и возвращается [`time.struct_time`](https://python-all.ru/3.13/library/time.html#time.struct_time) для нормализованного времени. `tm_isdst` принудительно устанавливается в 0. Обратите внимание, что может быть возбуждено [`OverflowError`](https://python-all.ru/3.13/library/exceptions.html#OverflowError), если `d.year` было `MINYEAR` или `MAXYEAR` и корректировка UTC выходит за границу года.10021003> **Предупреждение**1004>1005> Поскольку наивные объекты `datetime` рассматриваются многими методами `datetime` как местное время, предпочтительнее использовать осознанные объекты datetime для представления времени в UTC; как результат, использование `datetime.utctimetuple()` может давать вводящие в заблуждение результаты. Если у вас есть наивный `datetime`, представляющий UTC, используйте `datetime.replace(tzinfo=timezone.utc)`, чтобы сделать его осознанным, после чего можно использовать [`datetime.timetuple()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.timetuple).10061007#### `datetime.toordinal()`10081009Возвращает пролептический григорианский порядковый номер даты. То же, что `self.date().toordinal()`.10101011#### `datetime.timestamp()`10121013Возвращает временную метку POSIX, соответствующую экземпляру [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime). Возвращаемое значение – [`float`](https://python-all.ru/3.13/library/functions.html#float), похожее на то, что возвращается [`time.time()`](https://python-all.ru/3.13/library/time.html#time.time).10141015Наивные экземпляры [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) считаются представляющими местное время, и этот метод полагается на функцию C `mktime()` платформы для выполнения преобразования. Поскольку `datetime` поддерживает более широкий диапазон значений, чем `mktime()` на многих платформах, этот метод может возбуждать [`OverflowError`](https://python-all.ru/3.13/library/exceptions.html#OverflowError) или [`OSError`](https://python-all.ru/3.13/library/exceptions.html#OSError) для моментов времени в далёком прошлом или далёком будущем.10161017Для осознанных экземпляров [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) возвращаемое значение вычисляется как:10181019```python1020(dt - datetime(1970, 1, 1, tzinfo=timezone.utc)).total_seconds()1021```10221023Добавлено в версии 3.3.10241025Изменено в версии 3.6: Метод `timestamp()` использует атрибут [`fold`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.fold) для устранения неоднозначности моментов времени в течение повторяющегося интервала.10261027> **Примечание**1028>1029> Нет метода для получения временной метки POSIX непосредственно из наивного экземпляра [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime), представляющего время UTC. Если ваше приложение использует это соглашение и часовой пояс вашей системы не установлен на UTC, вы можете получить временную метку POSIX, указав `tzinfo=timezone.utc`:1030>1031> ```python1032> timestamp = dt.replace(tzinfo=timezone.utc).timestamp()1033> ```1034>1035> или вычислив метку напрямую:1036>1037> ```python1038> timestamp = (dt - datetime(1970, 1, 1)) / timedelta(seconds=1)1039> ```10401041#### `datetime.weekday()`10421043Возвращает день недели в виде целого числа, где понедельник – 0, а воскресенье – 6. То же, что `self.date().weekday()`. См. также [`isoweekday()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.isoweekday).10441045#### `datetime.isoweekday()`10461047Возвращает день недели в виде целого числа, где понедельник – 1, а воскресенье – 7. То же, что `self.date().isoweekday()`. См. также [`weekday()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.weekday), [`isocalendar()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.isocalendar).10481049#### `datetime.isocalendar()`10501051Возвращает [именованный кортеж](https://python-all.ru/3.13/glossary.html#term-named-tuple) с тремя компонентами: `year`, `week` и `weekday`. То же, что `self.date().isocalendar()`.10521053#### `datetime.isoformat(sep='T', timespec='auto')`10541055Возвращает строку, представляющую дату и время в формате ISO 8601:10561057- `YYYY-MM-DDTHH:MM:SS.ffffff`, если [`microsecond`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.microsecond) не равно 01058- `YYYY-MM-DDTHH:MM:SS`, если [`microsecond`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.microsecond) равно 010591060Если [`utcoffset()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.utcoffset) не возвращает `None`, добавляется строка с указанием смещения UTC:10611062- `YYYY-MM-DDTHH:MM:SS.ffffff+HH:MM[:SS[.ffffff]]`, если [`microsecond`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.microsecond) не равно 01063- `YYYY-MM-DDTHH:MM:SS+HH:MM[:SS[.ffffff]]`, если [`microsecond`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.microsecond) равно 010641065Примеры:10661067```python1068>>> import datetime as dt1069>>> dt.datetime(2019, 5, 18, 15, 17, 8, 132263).isoformat()1070'2019-05-18T15:17:08.132263'1071>>> dt.datetime(2019, 5, 18, 15, 17, tzinfo=dt.timezone.utc).isoformat()1072'2019-05-18T15:17:00+00:00'1073```10741075Необязательный аргумент *sep* (по умолчанию `'T'`) – это односимвольный разделитель, который ставится между частями даты и времени результата. Например:10761077```python1078>>> import datetime as dt1079>>> class TZ(dt.tzinfo):1080...     """Часовой пояс с произвольным постоянным смещением -06:39."""1081...     def utcoffset(self, when):1082...         return dt.timedelta(hours=-6, minutes=-39)1083...1084>>> dt.datetime(2002, 12, 25, tzinfo=TZ()).isoformat(' ')1085'2002-12-25 00:00:00-06:39'1086>>> dt.datetime(2009, 11, 27, microsecond=100, tzinfo=TZ()).isoformat()1087'2009-11-27T00:00:00.000100-06:39'1088```10891090Необязательный аргумент *timespec* указывает количество дополнительных компонентов времени, которые нужно включить (по умолчанию `'auto'`). Он может быть одним из следующих:10911092- `'auto'`: То же, что и `'seconds'`, если [`microsecond`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.microsecond) равно 0, иначе то же, что и `'microseconds'`.1093- `'hours'`: Включает [`hour`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.hour) в двухзначном формате `HH`.1094- `'minutes'`: Включает [`hour`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.hour) и [`minute`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.minute) в формате `HH:MM`.1095- `'seconds'`: Включает [`hour`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.hour), [`minute`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.minute) и [`second`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.second) в формате `HH:MM:SS`.1096- `'milliseconds'`: Включает полное время, но усекает дробную часть секунд до миллисекунд. Формат `HH:MM:SS.sss`.1097- `'microseconds'`: Включает полное время в формате `HH:MM:SS.ffffff`.10981099> **Примечание**1100>1101> Исключённые компоненты времени усекаются, а не округляются.11021103[`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError) будет возбуждено при недопустимом значении аргумента *timespec*:11041105```python1106>>> import datetime as dt1107>>> dt.datetime.now().isoformat(timespec='minutes')1108'2002-12-25T00:00'1109>>> my_datetime = dt.datetime(2015, 1, 1, 12, 30, 59, 0)1110>>> my_datetime.isoformat(timespec='microseconds')1111'2015-01-01T12:30:59.000000'1112```11131114Изменено в версии 3.6: Добавлен параметр *timespec*.11151116#### `datetime.__str__()`11171118Для экземпляра [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) `d` `str(d)` эквивалентно `d.isoformat(' ')`.11191120#### `datetime.ctime()`11211122Возвращает строку, представляющую дату и время:11231124```python1125>>> import datetime as dt1126>>> dt.datetime(2002, 12, 4, 20, 30, 40).ctime()1127'Wed Dec  4 20:30:40 2002'1128```11291130Результирующая строка *не* содержит информацию о часовом поясе независимо от того, является ли исходный объект aware или naive.11311132`d.ctime()` эквивалентно:11331134```python1135time.ctime(time.mktime(d.timetuple()))1136```11371138на платформах, где нативная C-функция `ctime()` (которая вызывается в [`time.ctime()`](https://python-all.ru/3.13/library/time.html#time.ctime), но не вызывается в `datetime.ctime()`) соответствует стандарту C.11391140#### `datetime.strftime(format)`11411142Возвращает строку, представляющую дату и время, управляемую явной строкой формата. См. также [Поведение strftime() и strptime()](https://python-all.ru/3.13/library/datetime.html#strftime-strptime-behavior) и [`datetime.isoformat()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.isoformat).11431144#### `datetime.__format__(format)`11451146То же, что и [`datetime.strftime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strftime). Это позволяет задать строку формата для объекта [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) в [f-строках](https://python-all.ru/3.13/reference/lexical_analysis.html#f-strings) и при использовании [`str.format()`](https://python-all.ru/3.13/library/stdtypes.html#str.format). См. также [Поведение strftime() и strptime()](https://python-all.ru/3.13/library/datetime.html#strftime-strptime-behavior) и [`datetime.isoformat()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.isoformat).11471148### Примеры использования: [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime)11491150Примеры работы с объектами [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime):11511152```pycon1153>>> import datetime as dt11541155>>> # Использование datetime.combine()1156>>> d = dt.date(2005, 7, 14)1157>>> t = dt.time(12, 30)1158>>> dt.datetime.combine(d, t)1159datetime.datetime(2005, 7, 14, 12, 30)11601161>>> # Использование datetime.now()1162>>> dt.datetime.now()1163datetime.datetime(2007, 12, 6, 16, 29, 43, 79043)   # GMT +11164>>> dt.datetime.now(dt.timezone.utc)1165datetime.datetime(2007, 12, 6, 15, 29, 43, 79060, tzinfo=datetime.timezone.utc)11661167>>> # Использование datetime.strptime()1168>>> my_datetime = dt.datetime.strptime("21/11/06 16:30", "%d/%m/%y %H:%M")1169>>> my_datetime1170datetime.datetime(2006, 11, 21, 16, 30)11711172>>> # Использование datetime.timetuple() для получения кортежа всех атрибутов1173>>> tt = my_datetime.timetuple()1174>>> for it in tt:1175...     print(it)1176...11772006    # year117811      # month117921      # day118016      # hour118130      # minute11820       # second11831       # weekday (0 = Monday)1184325     # number of days since 1st January1185-1      # dst - method tzinfo.dst() returned None11861187>>> # Дата в формате ISO1188>>> ic = my_datetime.isocalendar()1189>>> for it in ic:1190...     print(it)1191...11922006    # ISO year119347      # ISO week11942       # ISO weekday11951196>>> # Форматирование datetime1197>>> my_datetime.strftime("%A, %d. %B %Y %I:%M%p")1198'Tuesday, 21. November 2006 04:30PM'1199>>> 'The {1} is {0:%d}, the {2} is {0:%B}, the {3} is {0:%I:%M%p}.'.format(my_datetime, "day", "month", "time")1200'The day is 21, the month is November, the time is 04:30PM.'1201```12021203В приведённом ниже примере определяется подкласс [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo), который фиксирует информацию о часовом поясе для Кабула (Афганистан). До 1945 года там использовалось смещение +4 UTC, а затем +4:30 UTC:12041205```python1206import datetime as dt12071208class KabulTz(dt.tzinfo):1209    # В Кабуле до 1945 года использовали +4, затем перешли на +4:301210    UTC_MOVE_DATE = dt.datetime(1944, 12, 31, 20, tzinfo=dt.timezone.utc)12111212    def utcoffset(self, when):1213        if when.year < 1945:1214            return dt.timedelta(hours=4)1215        elif (1945, 1, 1, 0, 0) <= when.timetuple()[:5] < (1945, 1, 1, 0, 30):1216            # Неоднозначный («мнимый») получасовой диапазон, представляющий1217            # «складку» во времени из-за перехода с +4 на +4:30.1218            # Если when попадает в мнимый диапазон, используйте fold, чтобы решить, как1219            # разрешить неоднозначность. См. PEP 495.1220            return dt.timedelta(hours=4, minutes=(30 if when.fold else 0))1221        else:1222            return dt.timedelta(hours=4, minutes=30)12231224    def fromutc(self, when):1225        # Следуйте тем же проверкам, что и в datetime.tzinfo1226        if not isinstance(when, dt.datetime):1227            raise TypeError("fromutc() requires a datetime argument")1228        if when.tzinfo is not self:1229            raise ValueError("when.tzinfo is not self")12301231        # Для fromutc требуется собственная реализация, так как1232        # входные данные для этой функции – это datetime со значениями UTC1233        # но с tzinfo, установленным на self.1234        # См. datetime.astimezone или fromtimestamp.1235        if when.replace(tzinfo=dt.timezone.utc) >= self.UTC_MOVE_DATE:1236            return when + dt.timedelta(hours=4, minutes=30)1237        else:1238            return when + dt.timedelta(hours=4)12391240    def dst(self, when):1241        # В Кабуле не соблюдается летнее время.1242        return dt.timedelta(0)12431244    def tzname(self, when):1245        if when >= self.UTC_MOVE_DATE:1246            return "+04:30"1247        return "+04"1248```12491250Использование `KabulTz` из примера выше:12511252```python1253>>> tz1 = KabulTz()12541255>>> # Datetime до изменения1256>>> dt1 = dt.datetime(1900, 11, 21, 16, 30, tzinfo=tz1)1257>>> print(dt1.utcoffset())12584:00:0012591260>>> # Datetime после изменения1261>>> dt2 = dt.datetime(2006, 6, 14, 13, 0, tzinfo=tz1)1262>>> print(dt2.utcoffset())12634:30:0012641265>>> # Преобразовать datetime в другой часовой пояс1266>>> dt3 = dt2.astimezone(dt.timezone.utc)1267>>> dt31268datetime.datetime(2006, 6, 14, 8, 30, tzinfo=datetime.timezone.utc)1269>>> dt21270datetime.datetime(2006, 6, 14, 13, 0, tzinfo=KabulTz())1271>>> dt2 == dt31272True1273```12741275## [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) Объекты12761277Объект [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) представляет (локальное) время суток, не привязанное к определённому дню и может корректироваться с помощью объекта [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo).12781279#### `class datetime.time(hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)`12801281Все аргументы необязательны. *tzinfo* может быть `None` или экземпляром подкласса [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo). Остальные аргументы должны быть целыми числами в следующих диапазонах:12821283- `0 <= hour < 24`,1284- `0 <= minute < 60`,1285- `0 <= second < 60`,1286- `0 <= microsecond < 1000000`,1287- `fold in [0, 1]`.12881289Если указан аргумент вне этих диапазонов, возбуждается [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError). Все по умолчанию равны 0, кроме *tzinfo*, который по умолчанию равен `None`.12901291Атрибуты класса:12921293#### `time.min`12941295Самое раннее представимое [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time), `time(0, 0, 0, 0)`.12961297#### `time.max`12981299Самое позднее представимое [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time), `time(23, 59, 59, 999999)`.13001301#### `time.resolution`13021303Наименьшая возможная разница между неравными объектами [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time), `timedelta(microseconds=1)`, хотя следует отметить, что арифметические операции над объектами `time` не поддерживаются.13041305Атрибуты экземпляра (только для чтения):13061307#### `time.hour`13081309В `range(24)`.13101311#### `time.minute`13121313В `range(60)`.13141315#### `time.second`13161317В `range(60)`.13181319#### `time.microsecond`13201321В `range(1000000)`.13221323#### `time.tzinfo`13241325Объект, переданный как аргумент tzinfo конструктору [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time), или `None`, если ничего не было передано.13261327#### `time.fold`13281329В `[0, 1]`. Используется для устранения неоднозначности поясного времени в повторяющемся интервале. (Повторяющийся интервал возникает, когда часы переводятся назад в конце перехода на летнее время или когда смещение UTC для текущего часового пояса уменьшается по политическим причинам.) Значения 0 и 1 представляют соответственно более ранний и более поздний из двух моментов с одинаковым представлением поясного времени.13301331Добавлено в версии 3.6.13321333Объекты [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) поддерживают сравнение на равенство и порядок, где `a` считается меньше `b`, если `a` предшествует `b` во времени.13341335Наивные и осведомлённые объекты `time` никогда не равны. Сравнение по порядку между наивными и осведомлёнными объектами `time` вызывает [`TypeError`](https://python-all.ru/3.13/library/exceptions.html#TypeError).13361337Если оба сравниваемых объекта осведомлённые и имеют одинаковый атрибут [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.time.tzinfo), атрибуты `tzinfo` и `fold` игнорируются, и сравниваются базовые времена. Если оба сравниваемых объекта осведомлённые и имеют разные атрибуты `tzinfo`, сравниваемые объекты сначала корректируются путём вычитания их смещений UTC (полученных из `self.utcoffset()`).13381339Изменено в версии 3.3: Сравнения на равенство между осведомлёнными и наивными экземплярами [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) не вызывают [`TypeError`](https://python-all.ru/3.13/library/exceptions.html#TypeError).13401341В булевом контексте объект [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) всегда считается истинным.13421343Изменено в версии 3.5: До Python 3.5 объект [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) считался ложным, если он представлял полночь в UTC. Это поведение считалось неочевидным и чреватым ошибками и было удалено в Python 3.5. См. [bpo-13936](https://python-all.ru/3.13/library/datetime.html) для получения полной информации.13441345Другой конструктор:13461347#### `classmethod time.fromisoformat(time_string)`13481349Возвращает объект [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time), соответствующий строке *time\_string* в любом допустимом формате ISO 8601, со следующими исключениями:135013511. Смещения часовых поясов могут содержать доли секунды.13522. Ведущий символ `T`, обычно обязательный в случаях, когда возможна неоднозначность между датой и временем, не требуется.13533. Доли секунды могут содержать любое количество цифр (всё, что больше 6, будет усечено).13544. Доли часов и минут не поддерживаются.13551356Примеры:13571358```pycon1359>>> import datetime as dt1360>>> dt.time.fromisoformat('04:23:01')1361datetime.time(4, 23, 1)1362>>> dt.time.fromisoformat('T04:23:01')1363datetime.time(4, 23, 1)1364>>> dt.time.fromisoformat('T042301')1365datetime.time(4, 23, 1)1366>>> dt.time.fromisoformat('04:23:01.000384')1367datetime.time(4, 23, 1, 384)1368>>> dt.time.fromisoformat('04:23:01,000384')1369datetime.time(4, 23, 1, 384)1370>>> dt.time.fromisoformat('04:23:01+04:00')1371datetime.time(4, 23, 1, tzinfo=datetime.timezone(datetime.timedelta(seconds=14400)))1372>>> dt.time.fromisoformat('04:23:01Z')1373datetime.time(4, 23, 1, tzinfo=datetime.timezone.utc)1374>>> dt.time.fromisoformat('04:23:01+00:00')1375datetime.time(4, 23, 1, tzinfo=datetime.timezone.utc)1376```13771378Добавлено в версии 3.7.13791380Изменено в версии 3.11: Ранее этот метод поддерживал только форматы, которые могли быть возвращены [`time.isoformat()`](https://python-all.ru/3.13/library/datetime.html#datetime.time.isoformat).13811382Методы экземпляра:13831384#### `time.replace(hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond, tzinfo=self.tzinfo, *, fold=0)`13851386Возвращает новый объект [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) с теми же значениями, но с обновлёнными указанными параметрами. Обратите внимание, что `tzinfo=None` может быть указан для создания наивного `time` из осведомлённого `time` без преобразования данных времени.13871388Объекты [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) также поддерживаются обобщённой функцией [`copy.replace()`](https://python-all.ru/3.13/library/copy.html#copy.replace).13891390Изменено в версии 3.6: Добавлен параметр *fold*.13911392#### `time.isoformat(timespec='auto')`13931394Возвращает строку, представляющую время в формате ISO 8601, одну из:13951396- `HH:MM:SS.ffffff`, если [`microsecond`](https://python-all.ru/3.13/library/datetime.html#datetime.time.microsecond) не равно 01397- `HH:MM:SS`, если [`microsecond`](https://python-all.ru/3.13/library/datetime.html#datetime.time.microsecond) равно 01398- `HH:MM:SS.ffffff+HH:MM[:SS[.ffffff]]`, если [`utcoffset()`](https://python-all.ru/3.13/library/datetime.html#datetime.time.utcoffset) не возвращает `None`1399- `HH:MM:SS+HH:MM[:SS[.ffffff]]`, если [`microsecond`](https://python-all.ru/3.13/library/datetime.html#datetime.time.microsecond) равно 0 и [`utcoffset()`](https://python-all.ru/3.13/library/datetime.html#datetime.time.utcoffset) не возвращает `None`14001401Необязательный аргумент *timespec* указывает количество дополнительных компонентов времени, которые нужно включить (по умолчанию `'auto'`). Он может быть одним из следующих:14021403- `'auto'`: То же, что и `'seconds'`, если [`microsecond`](https://python-all.ru/3.13/library/datetime.html#datetime.time.microsecond) равно 0, иначе то же, что и `'microseconds'`.1404- `'hours'`: Включает [`hour`](https://python-all.ru/3.13/library/datetime.html#datetime.time.hour) в двухзначном формате `HH`.1405- `'minutes'`: Включает [`hour`](https://python-all.ru/3.13/library/datetime.html#datetime.time.hour) и [`minute`](https://python-all.ru/3.13/library/datetime.html#datetime.time.minute) в формате `HH:MM`.1406- `'seconds'`: Включает [`hour`](https://python-all.ru/3.13/library/datetime.html#datetime.time.hour), [`minute`](https://python-all.ru/3.13/library/datetime.html#datetime.time.minute) и [`second`](https://python-all.ru/3.13/library/datetime.html#datetime.time.second) в формате `HH:MM:SS`.1407- `'milliseconds'`: Включает полное время, но усекает дробную часть секунд до миллисекунд. Формат `HH:MM:SS.sss`.1408- `'microseconds'`: Включает полное время в формате `HH:MM:SS.ffffff`.14091410> **Примечание**1411>1412> Исключённые компоненты времени усекаются, а не округляются.14131414[`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError) будет вызвано при недопустимом аргументе *timespec*.14151416Пример:14171418```python1419>>> import datetime as dt1420>>> dt.time(hour=12, minute=34, second=56, microsecond=123456).isoformat(timespec='minutes')1421'12:34'1422>>> my_time = dt.time(hour=12, minute=34, second=56, microsecond=0)1423>>> my_time.isoformat(timespec='microseconds')1424'12:34:56.000000'1425>>> my_time.isoformat(timespec='auto')1426'12:34:56'1427```14281429Изменено в версии 3.6: Добавлен параметр *timespec*.14301431#### `time.__str__()`14321433Для времени `t` `str(t)` эквивалентно `t.isoformat()`.14341435#### `time.strftime(format)`14361437Возвращает строку, представляющую время, управляемую явной строкой формата. См. также [Поведение strftime() и strptime()](https://python-all.ru/3.13/library/datetime.html#strftime-strptime-behavior) и [`time.isoformat()`](https://python-all.ru/3.13/library/datetime.html#datetime.time.isoformat).14381439#### `time.__format__(format)`14401441То же, что [`time.strftime()`](https://python-all.ru/3.13/library/datetime.html#datetime.time.strftime). Это позволяет задать строку формата для объекта [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) в [форматированных строковых литералах](https://python-all.ru/3.13/reference/lexical_analysis.html#f-strings) и при использовании [`str.format()`](https://python-all.ru/3.13/library/stdtypes.html#str.format). См. также [Поведение strftime() и strptime()](https://python-all.ru/3.13/library/datetime.html#strftime-strptime-behavior) и [`time.isoformat()`](https://python-all.ru/3.13/library/datetime.html#datetime.time.isoformat).14421443#### `time.utcoffset()`14441445Если [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.time.tzinfo) равно `None`, возвращает `None`, иначе возвращает `self.tzinfo.utcoffset(None)`, и возбуждает исключение, если последнее не возвращает `None` или объект [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) с величиной менее одного дня.14461447Изменено в версии 3.7: Смещение UTC теперь не ограничено целым числом минут.14481449#### `time.dst()`14501451Если [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.time.tzinfo) равно `None`, возвращает `None`, иначе возвращает `self.tzinfo.dst(None)`, и возбуждает исключение, если последнее не возвращает `None` или объект [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) с величиной менее одного дня.14521453Изменено в версии 3.7: Смещение DST не ограничивается целым числом минут.14541455#### `time.tzname()`14561457Если [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.time.tzinfo) равно `None`, возвращает `None`, иначе возвращает `self.tzinfo.tzname(None)`, или возбуждает исключение, если последнее не возвращает `None` или строковый объект.14581459### Примеры использования: [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time)14601461Примеры работы с объектом [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time):14621463```python1464>>> import datetime as dt1465>>> class TZ1(dt.tzinfo):1466...     def utcoffset(self, when):1467...         return dt.timedelta(hours=1)1468...     def dst(self, when):1469...         return dt.timedelta(0)1470...     def tzname(self, when):1471...         return "+01:00"1472...     def  __repr__(self):1473...         return f"{self.__class__.__name__}()"1474...1475>>> t = dt.time(12, 10, 30, tzinfo=TZ1())1476>>> t1477datetime.time(12, 10, 30, tzinfo=TZ1())1478>>> t.isoformat()1479'12:10:30+01:00'1480>>> t.dst()1481datetime.timedelta(0)1482>>> t.tzname()1483'+01:00'1484>>> t.strftime("%H:%M:%S %Z")1485'12:10:30 +01:00'1486>>> 'The {} is {:%H:%M}.'.format("time", t)1487'The time is 12:10.'1488```14891490## [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo) Объекты14911492#### `class datetime.tzinfo`14931494Это абстрактный базовый класс, то есть этот класс не должен создаваться напрямую. Определите подкласс `tzinfo` для хранения информации о конкретном часовом поясе.14951496Экземпляр (конкретного подкласса) `tzinfo` можно передать конструкторам объектов [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) и [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time). Последние рассматривают свои атрибуты как местное время, а объект `tzinfo` поддерживает методы, показывающие смещение местного времени от UTC, название часового пояса и смещение DST – все относительно переданного им объекта даты или времени.14971498Необходимо создать конкретный подкласс и (как минимум) реализовать стандартные методы `tzinfo`, необходимые для используемых методов [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime). Модуль `datetime` предоставляет [`timezone`](https://python-all.ru/3.13/library/datetime.html#datetime.timezone) – простой конкретный подкласс `tzinfo`, который может представлять часовые пояса с фиксированным смещением от UTC, такие как сам UTC или североамериканские EST и EDT.14991500Особое требование для сериализации с помощью pickle: подкласс `tzinfo` должен иметь метод [`__init__()`](https://python-all.ru/3.13/reference/datamodel.html#object.__init__), который можно вызвать без аргументов, иначе объект можно сериализовать, но возможно не удастся десериализовать обратно. Это техническое требование, которое может быть ослаблено в будущем.15011502Конкретному подклассу `tzinfo` может потребоваться реализовать следующие методы. Какие именно методы нужны, зависит от того, как используются осведомлённые (aware) объекты `datetime`. Если есть сомнения, просто реализуйте их все.15031504#### `tzinfo.utcoffset(dt)`15051506Возвращает смещение местного времени от UTC в виде объекта [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta), которое положительно к востоку от UTC. Если местное время к западу от UTC, оно должно быть отрицательным.15071508Это представляет *общее* смещение от UTC; например, если объект [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo) представляет как часовой пояс, так и корректировки DST, `utcoffset()` должен возвращать их сумму. Если смещение UTC неизвестно, верните `None`. В противном случае возвращаемое значение должно быть объектом [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) строго между `-timedelta(hours=24)` и `timedelta(hours=24)` (величина смещения должна быть меньше одного дня). Большинство реализаций `utcoffset()` будут выглядеть как один из этих двух вариантов:15091510```python1511return CONSTANT                 # класс с фиксированным смещением1512return CONSTANT + self.dst(dt)  # класс, учитывающий летнее время1513```15141515Если `utcoffset()` не возвращает `None`, то [`dst()`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo.dst) также не должен возвращать `None`.15161517Реализация по умолчанию `utcoffset()` возбуждает [`NotImplementedError`](https://python-all.ru/3.13/library/exceptions.html#NotImplementedError).15181519Изменено в версии 3.7: Смещение UTC теперь не ограничено целым числом минут.15201521#### `tzinfo.dst(dt)`15221523Возвращает поправку на летнее время (DST) в виде объекта [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) или `None`, если информация о DST неизвестна.15241525Возвращает `timedelta(0)`, если DST не действует. Если DST действует, возвращает смещение в виде объекта [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta) (подробнее см. [`utcoffset()`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo.utcoffset)). Обратите внимание, что смещение DST, если применимо, уже добавлено к смещению UTC, возвращаемому `utcoffset()`, поэтому нет необходимости обращаться к `dst()`, если только вы не хотите получить информацию о DST отдельно. Например, [`datetime.timetuple()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.timetuple) вызывает метод `dst()` своего атрибута [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzinfo), чтобы определить, как должен быть установлен флаг [`tm_isdst`](https://python-all.ru/3.13/library/time.html#time.struct_time.tm_isdst), а [`tzinfo.fromutc()`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo.fromutc) вызывает `dst()` для учёта изменений DST при пересечении часовых поясов.15261527Экземпляр *tz* подкласса [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo), который моделирует как стандартное, так и летнее время, должен быть согласован в следующем смысле:15281529`tz.utcoffset(dt) - tz.dst(dt)`15301531должен возвращать один и тот же результат для каждого [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) *dt* с `dt.tzinfo == tz`. Для разумных подклассов `tzinfo` это выражение даёт «стандартное смещение» часового пояса, которое не должно зависеть от даты или времени, а только от географического положения. Реализация [`datetime.astimezone()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.astimezone) полагается на это, но не может обнаружить нарушения; ответственность за это лежит на программисте. Если подкласс `tzinfo` не может этого гарантировать, он может переопределить реализацию по умолчанию [`tzinfo.fromutc()`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo.fromutc), чтобы она корректно работала с `astimezone()` в любом случае.15321533Большинство реализаций `dst()`, вероятно, будут выглядеть как один из этих двух вариантов:15341535```python1536import datetime as dt15371538def dst(self, when):1539    # класс с фиксированным смещением: не учитывает летнее время1540    return dt.timedelta(0)1541```15421543или:15441545```python1546import datetime as dt15471548def dst(self, when):1549    # Код для установки dston и dstoff в значения летнего времени часового пояса1550    # время перехода на основе входного when.year, выраженное1551    # в стандартном местном времени.15521553    if dston <= when.replace(tzinfo=None) < dstoff:1554        return dt.timedelta(hours=1)1555    else:1556        return dt.timedelta(0)1557```15581559Реализация по умолчанию `dst()` вызывает исключение [`NotImplementedError`](https://python-all.ru/3.13/library/exceptions.html#NotImplementedError).15601561Изменено в версии 3.7: Смещение DST не ограничивается целым числом минут.15621563#### `tzinfo.tzname(dt)`15641565Возвращает название часового пояса, соответствующее объекту [`datetime`](https://python-all.ru/3.13/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.13/library/datetime.html#datetime.tzinfo) могут возвращать разные названия в зависимости от конкретного значения переданного *dt*, особенно если класс `tzinfo` учитывает летнее время.15661567Реализация по умолчанию `tzname()` вызывает исключение [`NotImplementedError`](https://python-all.ru/3.13/library/exceptions.html#NotImplementedError).15681569Эти методы вызываются объектом [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) или [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) в ответ на их одноимённые методы. Объект `datetime` передаёт себя в качестве аргумента, а объект `time` передаёт `None`. Поэтому методы подкласса [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo) должны быть готовы принять аргумент *dt* типа `None` или класса `datetime`.15701571Когда передаётся `None`, разработчик класса должен решить, какой ответ будет наилучшим. Например, возврат `None` уместен, если класс хочет показать, что объекты времени не участвуют в протоколах [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo). Возможно, более полезным будет, чтобы `utcoffset(None)` возвращал стандартное смещение UTC, так как нет другого соглашения для его определения.15721573Когда объект [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) передаётся в ответ на метод `datetime`, `dt.tzinfo` является тем же объектом, что и *self*. Методы [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo) могут на это полагаться, если только пользовательский код не вызывает методы `tzinfo` напрямую. Смысл в том, что методы `tzinfo` интерпретируют *dt* как местное время и не должны беспокоиться об объектах в других часовых поясах.15741575Существует ещё один метод [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo), который подкласс может переопределить:15761577#### `tzinfo.fromutc(dt)`15781579Этот метод вызывается из реализации по умолчанию [`datetime.astimezone()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.astimezone). При таком вызове `dt.tzinfo` является *self*, а данные даты и времени *dt* рассматриваются как время UTC. Цель `fromutc()` – скорректировать данные даты и времени, вернув эквивалентный datetime в местном времени *self*.15801581Большинство подклассов [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo) должны без проблем наследовать реализацию по умолчанию `fromutc()`. Она достаточно сильна, чтобы обрабатывать часовые пояса с фиксированным смещением, а также пояса, учитывающие стандартное и летнее время, причём последние – даже если время перехода на летнее время различается в разные годы. Пример часового пояса, который реализация по умолчанию `fromutc()` может обрабатывать неправильно в некоторых случаях, – это пояс, где стандартное смещение (от UTC) зависит от конкретной переданной даты и времени, что может происходить по политическим причинам. Реализации по умолчанию [`astimezone()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.astimezone) и `fromutc()` могут не дать желаемого результата, если результат приходится на часы, пересекающие момент изменения стандартного смещения.15821583Опуская код для обработки ошибок, реализация по умолчанию `fromutc()` работает следующим образом:15841585```python1586import datetime as dt15871588def fromutc(self, when):1589    # вызывает ValueError, если when.tzinfo не является self1590    dtoff = when.utcoffset()1591    dtdst = when.dst()1592    # вызывает ValueError, если dtoff или dtdst равны None1593    delta = dtoff - dtdst  # это стандартное смещение self1594    if delta:1595        when += delta   # преобразовать в стандартное местное время1596        dtdst = when.dst()1597        # вызывает ValueError, если dtdst равен None1598    if dtdst:1599        return when + dtdst1600    else:1601        return when1602```16031604В следующем файле [`tzinfo_examples.py`](https://python-all.ru/3.13/_downloads/6dc1f3f4f0e6ca13cb42ddf4d6cbc8af/tzinfo_examples.py) приведены некоторые примеры классов [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo):16051606```python1607import datetime as dt16081609# Класс, отражающий представление платформы о местном времени.1610# (Может приводить к неверным значениям для исторических моментов в1611#  часовых поясах, где UTC-смещение и/или правила летнего времени1612#  менялись в прошлом.)1613import time16141615ZERO = dt.timedelta(0)1616HOUR = dt.timedelta(hours=1)1617SECOND = dt.timedelta(seconds=1)16181619STDOFFSET = dt.timedelta(seconds=-time.timezone)1620if time.daylight:1621    DSTOFFSET = dt.timedelta(seconds=-time.altzone)1622else:1623    DSTOFFSET = STDOFFSET16241625DSTDIFF = DSTOFFSET - STDOFFSET16261627class LocalTimezone(dt.tzinfo):16281629    def fromutc(self, when):1630        assert when.tzinfo is self1631        stamp = (when - dt.datetime(1970, 1, 1, tzinfo=self)) // SECOND1632        args = time.localtime(stamp)[:6]1633        dst_diff = DSTDIFF // SECOND1634        # Обнаружение fold1635        fold = (args == time.localtime(stamp - dst_diff))1636        return dt.datetime(*args, microsecond=when.microsecond,1637                           tzinfo=self, fold=fold)16381639    def utcoffset(self, when):1640        if self._isdst(when):1641            return DSTOFFSET1642        else:1643            return STDOFFSET16441645    def dst(self, when):1646        if self._isdst(when):1647            return DSTDIFF1648        else:1649            return ZERO16501651    def tzname(self, when):1652        return time.tzname[self._isdst(when)]16531654    def _isdst(self, when):1655        tt = (when.year, when.month, when.day,1656              when.hour, when.minute, when.second,1657              when.weekday(), 0, 0)1658        stamp = time.mktime(tt)1659        tt = time.localtime(stamp)1660        return tt.tm_isdst > 016611662Local = LocalTimezone()16631664# Полная реализация текущих правил летнего времени для основных часовых поясов США.16651666def first_sunday_on_or_after(when):1667    days_to_go = 6 - when.weekday()1668    if days_to_go:1669        when += dt.timedelta(days_to_go)1670    return when16711672# Правила летнего времени в США1673#1674# Это упрощённый набор правил для США (т.е. неверный для некоторых случаев)1675# времени начала и окончания летнего времени. Полный и актуальный набор правил летнего времени1676# и определений часовых поясов смотрите в базе данных Olson (или попробуйте pytz):1677# http://www.twinsun.com/tz/tz-link.htm1678# https://sourceforge.net/projects/pytz/ (возможно, не актуально)1679#1680# В США с 2007 года летнее время начинается в 2 часа ночи (стандартное время) во второе1681# воскресенье марта, то есть первое воскресенье 8 марта или после него.1682DSTSTART_2007 = dt.datetime(1, 3, 8, 2)1683# и заканчивается в 2 часа ночи (летнее время) в первое воскресенье ноября.1684DSTEND_2007 = dt.datetime(1, 11, 1, 2)1685# С 1987 по 2006 год летнее время начиналось в 2 часа ночи (стандартное время) в первое1686# воскресенье апреля и заканчивалось в 2 часа ночи (летнее время) в последнее1687# воскресенье октября, то есть первое воскресенье 25 октября или после него.1688DSTSTART_1987_2006 = dt.datetime(1, 4, 1, 2)1689DSTEND_1987_2006 = dt.datetime(1, 10, 25, 2)1690# С 1967 по 1986 год летнее время начиналось в 2 часа ночи (стандартное время) в последнее1691# воскресенье апреля (то есть 24 апреля или после него) и заканчивалось в 2 часа ночи (летнее время)1692# в последнее воскресенье октября, которое является первым воскресеньем1693# 25 октября или позднее.1694DSTSTART_1967_1986 = dt.datetime(1, 4, 24, 2)1695DSTEND_1967_1986 = DSTEND_1987_200616961697def us_dst_range(year):1698    # Найти время начала и окончания перехода на летнее время в США. Для лет до 1967 года вернуть1699    # start = end, если летнее время не применяется.1700    if 2006 < year:1701        dststart, dstend = DSTSTART_2007, DSTEND_20071702    elif 1986 < year < 2007:1703        dststart, dstend = DSTSTART_1987_2006, DSTEND_1987_20061704    elif 1966 < year < 1987:1705        dststart, dstend = DSTSTART_1967_1986, DSTEND_1967_19861706    else:1707        return (dt.datetime(year, 1, 1), ) * 217081709    start = first_sunday_on_or_after(dststart.replace(year=year))1710    end = first_sunday_on_or_after(dstend.replace(year=year))1711    return start, end17121713class USTimeZone(dt.tzinfo):17141715    def __init__(self, hours, reprname, stdname, dstname):1716        self.stdoffset = dt.timedelta(hours=hours)1717        self.reprname = reprname1718        self.stdname = stdname1719        self.dstname = dstname17201721    def __repr__(self):1722        return self.reprname17231724    def tzname(self, when):1725        if self.dst(when):1726            return self.dstname1727        else:1728            return self.stdname17291730    def utcoffset(self, when):1731        return self.stdoffset + self.dst(when)17321733    def dst(self, when):1734        if when is None or when.tzinfo is None:1735            # В одном или обоих случаях здесь может быть уместно исключение.1736            # Это зависит от того, как вы хотите их обрабатывать. Реализация по умолчанию1737            # fromutc() (вызываемая реализацией astimezone() по умолчанию)1738            # передаёт объект datetime, у которого when.tzinfo равен self.1739            return ZERO1740        assert when.tzinfo is self1741        start, end = us_dst_range(when.year)1742        # Нельзя сравнивать наивные и осведомлённые объекты, поэтому сначала удалите часовой пояс из1743        # when.1744        when = when.replace(tzinfo=None)1745        if start + HOUR <= when < end - HOUR:1746            # Действует летнее время.1747            return HOUR1748        if end - HOUR <= when < end:1749            # Fold (неоднозначный час): используйте when.fold для разрешения неоднозначности.1750            return ZERO if when.fold else HOUR1751        if start <= when < start + HOUR:1752            # Gap (несуществующий час): примените обратное правило fold.1753            return HOUR if when.fold else ZERO1754        # Летнее время не действует.1755        return ZERO17561757    def fromutc(self, when):1758        assert when.tzinfo is self1759        start, end = us_dst_range(when.year)1760        start = start.replace(tzinfo=self)1761        end = end.replace(tzinfo=self)1762        std_time = when + self.stdoffset1763        dst_time = std_time + HOUR1764        if end <= dst_time < end + HOUR:1765            # Повторяющийся час1766            return std_time.replace(fold=1)1767        if std_time < start or dst_time >= end:1768            # Стандартное время1769            return std_time1770        if start <= std_time < end - HOUR:1771            # Летнее время1772            return dst_time17731774Eastern  = USTimeZone(-5, "Eastern",  "EST", "EDT")1775Central  = USTimeZone(-6, "Central",  "CST", "CDT")1776Mountain = USTimeZone(-7, "Mountain", "MST", "MDT")1777Pacific  = USTimeZone(-8, "Pacific",  "PST", "PDT")1778```17791780Обратите внимание, что в подклассе [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo), учитывающем как стандартное, так и летнее время, дважды в год в точках перехода на летнее время возникают неизбежные тонкости. Для конкретики рассмотрим восточное время США (UTC -0500), где EDT начинается через минуту после 1:59 (EST) во второе воскресенье марта и заканчивается через минуту после 1:59 (EDT) в первое воскресенье ноября:17811782```python1783  UTC   3:MM  4:MM  5:MM  6:MM  7:MM  8:MM1784  EST  22:MM 23:MM  0:MM  1:MM  2:MM  3:MM1785  EDT  23:MM  0:MM  1:MM  2:MM  3:MM  4:MM17861787start  22:MM 23:MM  0:MM  1:MM  3:MM  4:MM17881789  end  23:MM  0:MM  1:MM  1:MM  2:MM  3:MM1790```17911792Когда начинается летнее время (строка «start»), местные настенные часы перескакивают с 1:59 на 3:00. Местное время вида 2:MM в этот день не имеет смысла, поэтому `astimezone(Eastern)` не вернёт результат с `hour == 2` в день начала DST. Например, при переходе на летнее время весной 2016 года мы получаем:17931794```python1795>>> import datetime as dt1796>>> from tzinfo_examples import HOUR, Eastern1797>>> u0 = dt.datetime(2016, 3, 13, 5, tzinfo=dt.timezone.utc)1798>>> for i in range(4):1799...     u = u0 + i*HOUR1800...     t = u.astimezone(Eastern)1801...     print(u.time(), 'UTC =', t.time(), t.tzname())1802...180305:00:00 UTC = 00:00:00 EST180406:00:00 UTC = 01:00:00 EST180507:00:00 UTC = 03:00:00 EDT180608:00:00 UTC = 04:00:00 EDT1807```18081809Когда заканчивается летнее время (строка «end»), возникает потенциально более серьёзная проблема: есть час, который невозможно однозначно выразить в местном настенном времени – последний час летнего времени. В восточном поясе это время вида 5:MM UTC в день окончания летнего времени. Местные настенные часы перескакивают с 1:59 (летнее время) обратно на 1:00 (стандартное время). Местные времена вида 1:MM становятся неоднозначными. [`astimezone()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.astimezone) имитирует поведение местных часов, отображая два соседних часа UTC в один и тот же местный час. В примере с восточным поясом времена UTC вида 5:MM и 6:MM оба отображаются в 1:MM при преобразовании в восточное время, но у более ранних времен атрибут [`fold`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.fold) установлен в 0, а у более поздних – в 1. Например, при переходе на зимнее время осенью 2016 года мы получаем:18101811```python1812>>> import datetime as dt1813>>> from tzinfo_examples import HOUR, Eastern1814>>> u0 = dt.datetime(2016, 11, 6, 4, tzinfo=dt.timezone.utc)1815>>> for i in range(4):1816...     u = u0 + i*HOUR1817...     t = u.astimezone(Eastern)1818...     print(u.time(), 'UTC =', t.time(), t.tzname(), t.fold)1819...182004:00:00 UTC = 00:00:00 EDT 0182105:00:00 UTC = 01:00:00 EDT 0182206:00:00 UTC = 01:00:00 EST 1182307:00:00 UTC = 02:00:00 EST 01824```18251826Обратите внимание, что экземпляры [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime), отличающиеся только значением атрибута [`fold`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.fold), считаются равными при сравнении.18271828Приложения, которые не могут мириться с неоднозначностью местного времени, должны явно проверять значение атрибута [`fold`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.fold) или избегать использования гибридных подклассов [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo); неоднозначности отсутствуют при использовании [`timezone`](https://python-all.ru/3.13/library/datetime.html#datetime.timezone) или любого другого подкласса `tzinfo` с фиксированным смещением (например, класс, представляющий только EST (фиксированное смещение -5 часов) или только EDT (фиксированное смещение -4 часа)).18291830> **См. также**1831>1832> > **[`zoneinfo`](https://python-all.ru/3.13/library/zoneinfo.html#module-zoneinfo)**1833> >1834> > Модуль `datetime` содержит базовый класс [`timezone`](https://python-all.ru/3.13/library/datetime.html#datetime.timezone) (для обработки произвольных фиксированных смещений от UTC) и его атрибут [`timezone.utc`](https://python-all.ru/3.13/library/datetime.html#datetime.timezone.utc) (экземпляр UTC `timezone`).1835> >1836> > `zoneinfo` предоставляет Python базу данных *IANA time zone database* (также известную как база данных Olson), и её использование рекомендуется.1837>1838> **[база данных часовых поясов IANA](https://python-all.ru/3.13/library/datetime.html)**1839>1840> База данных часовых поясов (часто называемая tz, tzdata или zoneinfo) содержит код и данные, представляющие историю местного времени для множества характерных мест по всему миру. Она периодически обновляется, чтобы отражать изменения, вносимые политическими органами в границы часовых поясов, смещения UTC и правила перехода на летнее время.18411842## [`timezone`](https://python-all.ru/3.13/library/datetime.html#datetime.timezone) Объекты18431844Класс [`timezone`](https://python-all.ru/3.13/library/datetime.html#datetime.timezone) является подклассом [`tzinfo`](https://python-all.ru/3.13/library/datetime.html#datetime.tzinfo), каждый экземпляр которого представляет часовой пояс, определяемый фиксированным смещением от UTC.18451846Объекты этого класса нельзя использовать для представления информации о часовом поясе в местах, где в разные дни года используются разные смещения или где в гражданское время вносились исторические изменения.18471848#### `class datetime.timezone(offset, name=None)`18491850Аргумент *offset* должен быть задан как объект [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta), представляющий разницу между местным временем и UTC. Он должен находиться строго между `-timedelta(hours=24)` и `timedelta(hours=24)`, в противном случае возникает исключение [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError).18511852Аргумент *name* необязателен. Если он указан, это должна быть строка, которая будет использоваться в качестве значения, возвращаемого методом [`datetime.tzname()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzname).18531854Добавлено в версии 3.2.18551856Изменено в версии 3.7: Смещение UTC теперь не ограничено целым числом минут.18571858#### `timezone.utcoffset(dt)`18591860Возвращает фиксированное значение, указанное при создании экземпляра [`timezone`](https://python-all.ru/3.13/library/datetime.html#datetime.timezone).18611862Аргумент *dt* игнорируется. Возвращаемое значение – экземпляр [`timedelta`](https://python-all.ru/3.13/library/datetime.html#datetime.timedelta), равный разнице между местным временем и UTC.18631864Изменено в версии 3.7: Смещение UTC теперь не ограничено целым числом минут.18651866#### `timezone.tzname(dt)`18671868Возвращает фиксированное значение, указанное при создании экземпляра [`timezone`](https://python-all.ru/3.13/library/datetime.html#datetime.timezone).18691870Если *name* не указан в конструкторе, имя, возвращаемое `tzname(dt)`, генерируется из значения `offset` следующим образом. Если *offset* равно `timedelta(0)`, то имя – «UTC», иначе это строка в формате `UTC±HH:MM`, где ± – это знак `offset`, HH и MM – две цифры `offset.hours` и `offset.minutes` соответственно.18711872Изменено в версии 3.6: Имя, генерируемое из `offset=timedelta(0)`, теперь является обычным `'UTC'`, а не `'UTC+00:00'`.18731874#### `timezone.dst(dt)`18751876Всегда возвращает `None`.18771878#### `timezone.fromutc(dt)`18791880Возвращает `dt + offset`. Аргумент *dt* должен быть осведомлённым экземпляром [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime), с `tzinfo`, установленным в `self`.18811882Атрибуты класса:18831884#### `timezone.utc`18851886Часовой пояс UTC, `timezone(timedelta(0))`.18871888## [`strftime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strftime) и [`strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime) Поведение18891890Объекты [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date), [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) и [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) поддерживают метод `strftime(format)`, который создаёт строку, представляющую время с использованием явной строки формата.18911892И наоборот, метод класса [`datetime.strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime) создаёт объект [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) из строки, представляющей дату и время, и соответствующей строки формата.18931894Приведённая ниже таблица даёт высокоуровневое сравнение [`strftime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strftime) и [`strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime):18951896|  | `strftime` | `strptime` |1897| --- | --- | --- |1898| Использование | Преобразовать объект в строку по заданному формату | Разбирает строку в объект [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) по соответствующему формату. |1899| Тип метода | Метод экземпляра | Метод класса |1900| Метод | [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date); [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime); [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) | [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime) |1901| Сигнатура | `strftime(format)` | `strptime(date_string, format)` |19021903>19041905### [`strftime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strftime) и [`strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime) Коды форматов19061907Эти методы принимают коды формата, которые можно использовать для разбора и форматирования дат:19081909```python1910>>> import datetime as dt1911>>> dt.datetime.strptime('31/01/22 23:59:59.999999',1912...                      '%d/%m/%y %H:%M:%S.%f')1913datetime.datetime(2022, 1, 31, 23, 59, 59, 999999)1914>>> _.strftime('%a %d %b %Y, %I:%M%p')1915'Mon 31 Jan 2022, 11:59PM'1916```19171918Ниже приведён список всех кодов формата, требуемых стандартом C 1989 года, и они работают на всех платформах со стандартной реализацией C.19191920| Директива | Значение | Пример | Примечания |1921| --- | --- | --- | --- |1922| `%a` | День недели как сокращённое название в локали. | Sun, Mon, …, Sat (en\_US); So, Mo, …, Sa (de\_DE) | (1) |1923| `%A` | Название дня недели в полной форме, зависящее от локали. | Sunday, Monday, …, Saturday (en\_US); Sonntag, Montag, …, Samstag (de\_DE) | (1) |1924| `%w` | День недели в виде десятичного числа, где 0 – воскресенье, а 6 – суббота. | 0, 1, …, 6 |  |1925| `%d` | День месяца в виде десятичного числа, дополненного слева нулями. | 01, 02, …, 31 | (9) |1926| `%b` | Название месяца в сокращённой форме, зависящей от локали. | Jan, Feb, …, Dec (en\_US); Jan, Feb, …, Dez (de\_DE) | (1) |1927| `%B` | Название месяца в полной форме, зависящей от локали. | January, February, …, December (en\_US); Januar, Februar, …, Dezember (de\_DE) | (1) |1928| `%m` | Месяц в виде десятичного числа, дополненного слева нулями. | 01, 02, …, 12 | (9) |1929| `%y` | Год без столетия в виде десятичного числа, дополненного слева нулями. | 00, 01, …, 99 | (9) |1930| `%Y` | Год со столетием в виде десятичного числа. | 0001, 0002, …, 2013, 2014, …, 9998, 9999 | (2) |1931| `%H` | Часы (в 24-часовом формате) в виде десятичного числа, дополненного слева нулями. | 00, 01, …, 23 | (9) |1932| `%I` | Часы (в 12-часовом формате) в виде десятичного числа, дополненного слева нулями. | 01, 02, …, 12 | (9) |1933| `%p` | Эквивалент AM или PM, зависящий от локали. | AM, PM (en\_US); am, pm (de\_DE) | (1), (3) |1934| `%M` | Минуты в виде десятичного числа, дополненного слева нулями. | 00, 01, …, 59 | (9) |1935| `%S` | Секунды в виде десятичного числа, дополненного слева нулями. | 00, 01, …, 59 | (4), (9) |1936| `%f` | Микросекунды в виде десятичного числа, дополненного слева нулями до 6 цифр. | 000000, 000001, …, 999999 | (5) |1937| `%z` | Смещение UTC в формате `±HHMM[SS[.ffffff]]` (пустая строка, если объект наивный). | (пусто), +0000, -0400, +1030, +063415, -030712.345216 | (6) |1938| `%Z` | Название часового пояса (пустая строка, если объект наивный). | (пусто), UTC, GMT | (6) |1939| `%j` | День года в виде десятичного числа, дополненного слева нулями. | 001, 002, …, 366 | (9) |1940| `%U` | Номер недели в году (воскресенье – первый день недели) в виде десятичного числа, дополненного слева нулями. Все дни в новом году до первого воскресенья считаются неделей 0. | 00, 01, …, 53 | (7), (9) |1941| `%W` | Номер недели в году (понедельник – первый день недели) в виде десятичного числа, дополненного слева нулями. Все дни в новом году до первого понедельника считаются неделей 0. | 00, 01, …, 53 | (7), (9) |1942| `%c` | Представление даты и времени, подходящее для локали. | Tue Aug 16 21:30:00 1988 (en\_US); Di 16 Aug 21:30:00 1988 (de\_DE) | (1) |1943| `%x` | Представление даты, соответствующее локали. | 08/16/88 (None); 08/16/1988 (en\_US); 16.08.1988 (de\_DE) | (1) |1944| `%X` | Представление времени, соответствующее локали. | 21:30:00 (en\_US); 21:30:00 (de\_DE) | (1) |1945| `%%` | Литеральный символ `'%'`. | % |  |19461947Для удобства включено несколько дополнительных директив, не требуемых стандартом C89. Все эти параметры соответствуют значениям дат ISO 8601.19481949| Директива | Значение | Пример | Примечания |1950| --- | --- | --- | --- |1951| `%G` | Год по ISO 8601 с веком, представляющий год, который содержит большую часть недели по ISO 8601 (`%V`). | 0001, 0002, …, 2013, 2014, …, 9998, 9999 | (8) |1952| `%u` | День недели по ISO 8601 в виде десятичного числа, где 1 – понедельник. | 1, 2, …, 7 |  |1953| `%V` | Неделя по ISO 8601 в виде десятичного числа, где понедельник считается первым днём недели. Неделя 01 – это неделя, содержащая 4 января. | 01, 02, …, 53 | (8), (9) |1954| `%:z` | Смещение UTC в формате `±HH:MM[:SS[.ffffff]]` (пустая строка, если объект наивный). | (пусто), +00:00, -04:00, +10:30, +06:34:15, -03:07:12.345216 | (6) |19551956Они могут быть доступны не на всех платформах при использовании с методом [`strftime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strftime). Директивы года по ISO 8601 и недели по ISO 8601 не взаимозаменяемы с указанными выше директивами года и номера недели. Вызов [`strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime) с неполными или неоднозначными директивами ISO 8601 приведёт к возникновению [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError).19571958Полный набор поддерживаемых кодов формата зависит от платформы, поскольку Python вызывает функцию `strftime()` из библиотеки C платформы, а различия между платформами распространены. Чтобы увидеть полный набор кодов формата, поддерживаемых на вашей платформе, обратитесь к документации *[strftime(3)](https://python-all.ru/3.13/library/datetime.html)*. Также существуют различия между платформами в обработке неподдерживаемых спецификаторов формата.19591960Добавлено в версии 3.6: `%G`, `%u` и `%V` были добавлены.19611962Добавлено в версии 3.12: `%:z` был добавлен.19631964### Технические детали19651966В целом, `d.strftime(fmt)` действует как [`time`](https://python-all.ru/3.13/library/time.html#module-time) из модуля `time.strftime(fmt, d.timetuple())`, хотя не все объекты поддерживают метод [`timetuple()`](https://python-all.ru/3.13/library/datetime.html#datetime.date.timetuple).19671968Для метода класса [`datetime.strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime) значением по умолчанию является `1900-01-01T00:00:00.000`: любые компоненты, не указанные в строке формата, будут взяты из значения по умолчанию.19691970> **Примечание**1971>1972> Строки формата без разделителей могут быть неоднозначными для разбора. Например, при `%Y%m%d` строка `2026111` может быть разобрана как `2026-11-01` или как `2026-01-11`. Используйте разделители, чтобы гарантировать, что входные данные разбираются так, как задумано.19731974> **Примечание**1975>1976> При разборе частичных дат без года, [`datetime.strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime) вызовет исключение при встрече 29 февраля, поскольку год по умолчанию 1900 *не* является високосным. Всегда добавляйте високосный год по умолчанию к строкам с частичными датами перед разбором.19771978```pycon1979>>> import datetime as dt1980>>> value = "2/29"1981>>> dt.datetime.strptime(value, "%m/%d")1982Traceback (most recent call last):1983...1984ValueError: day 29 must be in range 1..28 for month 2 in year 19001985>>> dt.datetime.strptime(f"1904 {value}", "%Y %m/%d")1986datetime.datetime(1904, 2, 29, 0, 0)1987```19881989Использование `datetime.strptime(date_string, format)` эквивалентно:19901991```python1992datetime(*(time.strptime(date_string, format)[0:6]))1993```19941995за исключением случаев, когда формат включает компоненты долей секунды или информацию о часовом поясе, которые поддерживаются в `datetime.strptime`, но отбрасываются `time.strptime`.19961997Для объектов [`time`](https://python-all.ru/3.13/library/datetime.html#datetime.time) не следует использовать коды формата для года, месяца и дня, поскольку у объектов `time` таких значений нет. Если они всё же используются, для года подставляется 1900, а для месяца и дня – 1.19981999Для объектов [`date`](https://python-all.ru/3.13/library/datetime.html#datetime.date) не следует использовать коды формата для часов, минут, секунд и микросекунд, поскольку у объектов `date` таких значений нет. Если они всё же используются, для них подставляется 0.20002001По той же причине обработка строк формата, содержащих кодовые точки Unicode, которые не могут быть представлены в кодировке текущей локали, также зависит от платформы. На некоторых платформах такие кодовые точки сохраняются в выходных данных без изменений, в то время как на других `strftime` может вызвать [`UnicodeError`](https://python-all.ru/3.13/library/exceptions.html#UnicodeError) или вернуть пустую строку.20022003Примечания:200420051. Поскольку формат зависит от текущей локали, следует проявлять осторожность при построении предположений о выходном значении. Порядок полей различается (например, «месяц/день/год» против «день/месяц/год»), и вывод может содержать не-ASCII символы.20062. Метод [`strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime) может разбирать годы в полном диапазоне \[1, 9999\], но годы \< 1000 должны быть дополнены нулями до 4-значной ширины.20072008   Изменено в версии 3.2: В предыдущих версиях метод [`strftime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strftime) был ограничен gодами \>= 1900.20092010   Изменено в версии 3.3: В версии 3.2 метод [`strftime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strftime) был ограничен gодами \>= 1000.20113. При использовании с методом [`strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime) директива `%p` влияет только на поле вывода часа, если директива `%I` используется для разбора часа.20124. В отличие от модуля [`time`](https://python-all.ru/3.13/library/time.html#module-time), модуль `datetime` не поддерживает високосные секунды.20135. При использовании с методом [`strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime) директива `%f` принимает от одной до шести цифр и дополняет нулями справа. `%f` является расширением набора символов форматирования в стандарте C (но реализован отдельно в объектах datetime, поэтому всегда доступен).20146. Для наивного объекта коды форматирования `%z`, `%:z` и `%Z` заменяются пустыми строками.20152016   Для осведомлённого объекта:20172018   **`%z`**20192020   [`utcoffset()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.utcoffset) преобразуется в строку вида `±HHMM[SS[.ffffff]]`, где `HH` – двухсимвольная строка, задающая количество часов смещения UTC, `MM` – двухсимвольная строка, задающая количество минут смещения UTC, `SS` – двухсимвольная строка, задающая количество секунд смещения UTC, а `ffffff` – шестисимвольная строка, задающая количество микросекунд смещения UTC. Часть `ffffff` опускается, если смещение составляет целое число секунд, а части `ffffff` и `SS` опускаются, если смещение составляет целое число минут. Например, если `utcoffset()` возвращает `timedelta(hours=-3, minutes=-30)`, то `%z` заменяется строкой `'-0330'`.20212022   Изменено в версии 3.7: Смещение UTC теперь не ограничено целым числом минут.20232024   Изменено в версии 3.7: Когда директива `%z` передаётся методу [`strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime), смещения UTC могут содержать двоеточие в качестве разделителя между часами, минутами и секундами. Например, `'+01:00:00'` будет разобрано как смещение в один час. Кроме того, указание `'Z'` эквивалентно `'+00:00'`.20252026   **`%:z`**20272028   Ведёт себя точно так же, как `%z`, но с добавлением двоеточия в качестве разделителя между часами, минутами и секундами.20292030   **`%Z`**20312032   В [`strftime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strftime) `%Z` заменяется пустой строкой, если [`tzname()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.tzname) возвращает `None`; в противном случае `%Z` заменяется возвращённым значением, которое должно быть строкой.20332034   [`strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime) принимает только определённые значения для `%Z`:20352036   1. любое значение из `time.tzname` для локали вашей системы2037   2. жёстко заданные значения `UTC` и `GMT`20382039   Так, человек, живущий в Японии, может иметь `JST`, `UTC` и `GMT` в качестве допустимых значений, но, вероятно, не `EST`. Для недопустимых значений будет возбуждено `ValueError`.20402041   Изменено в версии 3.2: Когда директива `%z` передаётся методу [`strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime), будет создан осведомлённый объект [`datetime`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime). Атрибут `tzinfo` результата будет установлен в экземпляр [`timezone`](https://python-all.ru/3.13/library/datetime.html#datetime.timezone).20427. При использовании с методом [`strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime) `%U` и `%W` используются только в вычислениях, когда указаны день недели и календарный год (`%Y`).20438. Аналогично `%U` и `%W`, `%V` используется только в вычислениях, когда день недели и год по ISO (`%G`) указаны в строке форматирования [`strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime). Также обратите внимание, что `%G` и `%Y` не являются взаимозаменяемыми.20449. При использовании с методом [`strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime) ведущий ноль является необязательным для форматов `%d`, `%m`, `%H`, `%I`, `%M`, `%S`, `%j`, `%U`, `%W` и `%V`. Формат `%y` требует ведущего нуля.204510. При разборе месяца и дня с помощью [`strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime) всегда включайте год в формат. Если разбираемое значение не содержит года, добавьте явный фиктивный високосный год. В противном случае ваш код возбудит исключение при обнаружении високосного дня, так как год по умолчанию, используемый парсером (1900), не является високосным. Пользователи сталкиваются с этой ошибкой каждый високосный год.20462047    ```pycon2048    >>> month_day = "02/29"2049    >>> dt.datetime.strptime(f"{month_day};1984", "%m/%d;%Y")  # Нет ошибки високосного года.2050    datetime.datetime(1984, 2, 29, 0, 0)2051    ```20522053    Устарело с версии 3.13, будет удалено в версии 3.15: Вызовы [`strptime()`](https://python-all.ru/3.13/library/datetime.html#datetime.datetime.strptime) с использованием строки форматирования, содержащей день месяца без года, теперь вызывают [`DeprecationWarning`](https://python-all.ru/3.13/library/exceptions.html#DeprecationWarning). В версии 3.15 или позднее это может быть изменено на ошибку или год по умолчанию может быть изменён на високосный. См. [gh-70647](https://python-all.ru/3.13/library/datetime.html).20542055Сноски20562057\[[1](https://python-all.ru/3.13/library/datetime.html#id1)\]20582059Если, конечно, пренебречь эффектами относительности.20602061\[[2](https://python-all.ru/3.13/library/datetime.html#id2)\]20622063Это соответствует определению пролептического григорианского календаря в книге Дершовица и Рейнгольда *Calendrical Calculations*, где он является базовым календарём для всех вычислений. Смотрите книгу для алгоритмов преобразования между пролептическими григорианскими порядковыми номерами и многими другими календарными системами.20642065\[[3](https://python-all.ru/3.13/library/datetime.html#id3)\]20662067Смотрите [руководство по математике календаря ISO 8601](https://python-all.ru/3.13/library/datetime.html) Р. Х. ван Гента для хорошего объяснения.2068