datetime.md
1> **Источник:** https://python-all.ru/3/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.14/Lib/datetime.py)1011---1213Модуль `datetime` предоставляет классы для работы с датами и временем.1415Хотя арифметика дат и времени поддерживается, основное внимание в реализации уделяется эффективному извлечению атрибутов для форматирования и обработки вывода.1617> **Совет**18>19> Перейти к [кодам форматирования](https://python-all.ru/3/library/datetime.html#format-codes).2021> **См. также**22>23> **Модуль [`calendar`](https://python-all.ru/3/library/calendar.html#module-calendar)**24>25> Общие функции, связанные с календарём.26>27> **Модуль [`time`](https://python-all.ru/3/library/time.html#module-time)**28>29> Доступ к времени и преобразования.30>31> **Модуль [`zoneinfo`](https://python-all.ru/3/library/zoneinfo.html#module-zoneinfo)**32>33> Конкретные часовые пояса, представляющие базу данных часовых поясов IANA.34>35> **Пакет [dateutil](https://python-all.ru/3/library/datetime.html)**36>37> Сторонняя библиотека с расширенной поддержкой часовых поясов и разбора.38>39> **Пакет [DateType](https://python-all.ru/3/library/datetime.html)**40>41> Сторонняя библиотека, которая вводит отдельные статические типы, чтобы, например, позволить [статическим проверкам типов](https://python-all.ru/3/glossary.html#term-static-type-checker) различать наивные и осведомлённые объекты datetime.4243## Осведомлённые и наивные объекты4445Объекты даты и времени могут быть отнесены к категории «осведомлённых» или «наивных» в зависимости от того, содержат ли они информацию о часовом поясе.4647При достаточном знании применимых алгоритмических и политических поправок времени, таких как информация о часовом поясе и переходе на летнее время, **осведомлённый** объект может определить своё положение относительно других осведомлённых объектов. Осведомлённый объект представляет конкретный момент времени, не допускающий неоднозначного толкования. [\[1\]](https://python-all.ru/3/library/datetime.html#id4)4849**Наивный** объект не содержит достаточно информации, чтобы однозначно определить своё положение относительно других объектов даты/времени. Представляет ли наивный объект Всемирное координированное время (UTC), местное время или время в другом часовом поясе – это полностью зависит от программы, так же как от программы зависит, представляет ли конкретное число метры, мили или массу. Наивные объекты легко понять и использовать, ценой игнорирования некоторых аспектов реальности.5051Для приложений, требующих осведомлённых объектов, объекты [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) и [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) имеют необязательный атрибут информации о часовом поясе `tzinfo`, который может быть установлен в экземпляр подкласса абстрактного класса `tzinfo`. Эти объекты [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo) содержат информацию о смещении от UTC, названии часового пояса и о том, действует ли летнее время.5253Только один конкретный класс [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo), класс [`timezone`](https://python-all.ru/3/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/library/datetime.html#datetime.date) или [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime). [`MINYEAR`](https://python-all.ru/3/library/datetime.html#datetime.MINYEAR) равен 1.6263#### `datetime.MAXYEAR`6465Наибольший номер года, допустимый в объекте [`date`](https://python-all.ru/3/library/datetime.html#datetime.date) или [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime). [`MAXYEAR`](https://python-all.ru/3/library/datetime.html#datetime.MAXYEAR) равен 9999.6667#### `datetime.UTC`6869Псевдоним для синглтона часового пояса UTC [`datetime.timezone.utc`](https://python-all.ru/3/library/datetime.html#datetime.timezone.utc).7071Добавлено в версии 3.12.7273## Доступные типы7475#### `class datetime.date`7677Идеализированная наивная дата, предполагающая, что текущий григорианский календарь действовал всегда и будет действовать всегда. Атрибуты: [`year`](https://python-all.ru/3/library/datetime.html#datetime.date.year), [`month`](https://python-all.ru/3/library/datetime.html#datetime.date.month) и [`day`](https://python-all.ru/3/library/datetime.html#datetime.date.day).7879#### `class datetime.time`8081Идеализированное время, независимое от какого-либо конкретного дня, предполагающее, что каждый день содержит ровно 24\*60\*60 секунд. (Здесь нет понятия «високосные секунды».) Атрибуты: [`hour`](https://python-all.ru/3/library/datetime.html#datetime.time.hour), [`minute`](https://python-all.ru/3/library/datetime.html#datetime.time.minute), [`second`](https://python-all.ru/3/library/datetime.html#datetime.time.second), [`microsecond`](https://python-all.ru/3/library/datetime.html#datetime.time.microsecond) и [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.time.tzinfo).8283#### `class datetime.datetime`8485Комбинация даты и времени. Атрибуты: [`year`](https://python-all.ru/3/library/datetime.html#datetime.datetime.year), [`month`](https://python-all.ru/3/library/datetime.html#datetime.datetime.month), [`day`](https://python-all.ru/3/library/datetime.html#datetime.datetime.day), [`hour`](https://python-all.ru/3/library/datetime.html#datetime.datetime.hour), [`minute`](https://python-all.ru/3/library/datetime.html#datetime.datetime.minute), [`second`](https://python-all.ru/3/library/datetime.html#datetime.datetime.second), [`microsecond`](https://python-all.ru/3/library/datetime.html#datetime.datetime.microsecond), и [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo).8687#### `class datetime.timedelta`8889Длительность, представляющая разницу между двумя экземплярами [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) или [`date`](https://python-all.ru/3/library/datetime.html#datetime.date) с точностью до микросекунды.9091#### `class datetime.tzinfo`9293Абстрактный базовый класс для объектов информации о часовых поясах. Они используются классами [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) и [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) для предоставления настраиваемого понятия коррекции времени (например, для учёта часового пояса и/или летнего времени).9495#### `class datetime.timezone`9697Класс, реализующий абстрактный базовый класс [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo) в виде фиксированного смещения от UTC.9899Добавлено в версии 3.2.100101Объекты этих типов неизменяемы.102103Отношения подклассов:104105106107### Общие свойства108109Типы [`date`](https://python-all.ru/3/library/datetime.html#datetime.date), [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime), [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) и [`timezone`](https://python-all.ru/3/library/datetime.html#datetime.timezone) имеют следующие общие особенности:110111- Объекты этих типов неизменяемы.112- Объекты этих типов являются [хешируемыми](https://python-all.ru/3/glossary.html#term-hashable), то есть могут использоваться в качестве ключей словаря.113- Объекты этих типов поддерживают эффективную сериализацию с помощью модуля [`pickle`](https://python-all.ru/3/library/pickle.html#module-pickle).114115### Определение, является ли объект aware или naive116117Объекты типа [`date`](https://python-all.ru/3/library/datetime.html#datetime.date) всегда naive.118119Объект типа [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) или [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) может быть aware или naive.120121Объект [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) `d` является aware, если выполняются оба следующих условия:1221231. `d.tzinfo` не является `None`1242. `d.tzinfo.utcoffset(d)` не возвращает `None`125126В противном случае `d` является naive.127128Объект [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) `t` является aware, если выполняются оба следующих условия:1291301. `t.tzinfo` не является `None`1312. `t.tzinfo.utcoffset(None)` не возвращает `None`.132133В противном случае `t` является naive.134135Различие между aware и naive не применимо к объектам [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta) .136137## `timedelta` объекты138139Объект [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta) представляет длительность, разницу между двумя экземплярами [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) или [`date`](https://python-all.ru/3/library/datetime.html#datetime.date).140141#### `class datetime.timedelta(days=0, seconds=0, microseconds=0, milliseconds=0, minutes=0, hours=0, weeks=0)`142143Все аргументы необязательны и по умолчанию равны 0. Аргументы могут быть целыми числами или числами с плавающей запятой, а также могут быть положительными или отрицательными.144145Внутри хранятся только *days*, *seconds* и *microseconds*. Аргументы преобразуются в эти единицы:146147- Миллисекунда преобразуется в 1000 микросекунд.148- Минута преобразуется в 60 секунд.149- Час преобразуется в 3600 секунд.150- Неделя преобразуется в 7 дней.151152а затем дни, секунды и микросекунды нормализуются так, что представление уникально, с153154- `0 <= microseconds < 1000000`155- `0 <= seconds < 3600*24` (количество секунд в одном дне)156- `-999999999 <= days <= 999999999`157158Следующий пример показывает, как любые аргументы, кроме *days*, *seconds* и *microseconds*, «объединяются» и нормализуются в эти три результирующих атрибута:159160```python161>>> import datetime as dt162>>> delta = dt.timedelta(163... days=50,164... seconds=27,165... microseconds=10,166... milliseconds=29000,167... minutes=5,168... hours=8,169... weeks=2170... )171>>> # Остаются только дни, секунды и микросекунды172>>> delta173datetime.timedelta(days=64, seconds=29156, microseconds=10)174```175176> **Совет**177>178> `import datetime as dt` вместо `import datetime` или `from datetime import datetime`, чтобы избежать путаницы между модулем и классом. См. [Как я импортирую модуль datetime в Python](https://python-all.ru/3/library/datetime.html).179180Если какой-либо аргумент является числом с плавающей запятой и есть дробные микросекунды, то дробные микросекунды, оставшиеся от всех аргументов, объединяются, и их сумма округляется до ближайшей микросекунды с использованием правила округления до ближайшего чётного. Если ни один аргумент не является числом с плавающей запятой, процессы преобразования и нормализации являются точными (информация не теряется).181182Если нормализованное значение дней выходит за указанный диапазон, возбуждается [`OverflowError`](https://python-all.ru/3/library/exceptions.html#OverflowError).183184Обратите внимание, что нормализация отрицательных значений может сначала показаться неожиданной. Например:185186```python187>>> import datetime as dt188>>> d = dt.timedelta(microseconds=-1)189>>> (d.days, d.seconds, d.microseconds)190(-1, 86399, 999999)191```192193Поскольку строковое представление объектов `timedelta` может сбивать с толку, используйте следующий рецепт, чтобы получить более читаемый формат:194195```pycon196>>> def pretty_timedelta(td):197... if td.days >= 0:198... return str(td)199... return f'-({-td!s})'200...201>>> d = timedelta(hours=-1)202>>> str(d) # неудобно для человека203'-1 day, 23:00:00'204>>> pretty_timedelta(d)205'-(1:00:00)'206```207208Атрибуты класса:209210#### `timedelta.min`211212Наиболее отрицательный объект [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta), `timedelta(-999999999)`.213214#### `timedelta.max`215216Наиболее положительный объект [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta), `timedelta(days=999999999, hours=23, minutes=59, seconds=59, microseconds=999999)`.217218#### `timedelta.resolution`219220Наименьшая возможная разница между неравными объектами [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta), `timedelta(microseconds=1)`.221222Обратите внимание, что из-за нормализации `timedelta.max` больше, чем `-timedelta.min`. `-timedelta.max` не представим как объект [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta).223224Атрибуты экземпляра (только для чтения):225226#### `timedelta.days`227228От -999,999,999 до 999,999,999 включительно.229230#### `timedelta.seconds`231232От 0 до 86,399 включительно.233234> **Внимание**235>236> Это довольно распространённая ошибка, когда код непреднамеренно использует этот атрибут, хотя на самом деле предполагается получить значение [`total_seconds()`](https://python-all.ru/3/library/datetime.html#datetime.timedelta.total_seconds) вместо этого:237>238> ```pycon239> >>> import datetime as dt240> >>> duration = dt.timedelta(seconds=11235813)241> >>> duration.days, duration.seconds242> (130, 3813)243> >>> duration.total_seconds()244> 11235813.0245> ```246247#### `timedelta.microseconds`248249От 0 до 999,999 включительно.250251Поддерживаемые операции:252253| Операция | Результат |254| --- | --- |255| `t1 = t2 + t3` | Сумма `t2` и `t3`. После этого `t1 - t2 == t3` и `t1 - t3 == t2` истинны. (1) |256| `t1 = t2 - t3` | Разность `t2` и `t3`. После этого `t1 == t2 - t3` и `t2 == t1 + t3` истинны. (1)(6) |257| `t1 = t2 * i or t1 = i * t2` | Дельта, умноженная на целое число. После этого `t1 // i == t2` истинно, при условии `i != 0`. |258| | В общем случае `t1 * i == t1 * (i-1) + t1` истинно. (1) |259| `t1 = t2 * f or t1 = f * t2` | Дельта, умноженная на число с плавающей запятой. Результат округляется до ближайшего кратного timedelta.resolution по правилу round-half-to-even. |260| `f = t2 / t3` | Деление (3) общей длительности `t2` на единицу интервала `t3`. Возвращает объект [`float`](https://python-all.ru/3/library/functions.html#float). |261| `t1 = t2 / f or t1 = t2 / i` | Дельта, делённая на число с плавающей запятой или целое число. Результат округляется до ближайшего кратного timedelta.resolution по правилу round-half-to-even. |262| `t1 = t2 // i` или `t1 = t2 // t3` | Вычисляется целая часть, а остаток (если он есть) отбрасывается. Во втором случае возвращается целое число. (3) |263| `t1 = t2 % t3` | Остаток вычисляется как объект [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta). (3) |264| `q, r = divmod(t1, t2)` | Вычисляет частное и остаток: `q = t1 // t2` (3) и `r = t1 % t2`. `q` – целое число, а `r` – объект [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta). |265| `+t1` | Возвращает объект [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta) с тем же значением. (2) |266| `-t1` | Эквивалентно `timedelta(-t1.days, -t1.seconds, -t1.microseconds)` и `t1 * -1`. (1)(4) |267| `abs(t)` | Эквивалентно `+t`, когда `t.days >= 0`, и `-t`, когда `t.days < 0`. (2) |268| `str(t)` | Возвращает строку вида `[D day[s], ][H]H:MM:SS[.UUUUUU]`, где D отрицательно для отрицательного `t`. (5) |269| `repr(t)` | Возвращает строковое представление объекта [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta) в виде вызова конструктора с каноническими значениями атрибутов. |270271Примечания:2722731. Это точное, но может привести к переполнению.2742. Это точное и не может привести к переполнению.2753. Деление на ноль вызывает [`ZeroDivisionError`](https://python-all.ru/3/library/exceptions.html#ZeroDivisionError).2764. `-timedelta.max` не представимо в виде объекта [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta).2775. Строковые представления [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta) объектов нормализуются аналогично их внутреннему представлению. Это приводит к несколько необычным результатам для отрицательных объектов timedelta. Например:278279 ```python280 >>> timedelta(hours=-5)281 datetime.timedelta(days=-1, seconds=68400)282 >>> print(_)283 -1 day, 19:00:00284 ```2856. Выражение `t2 - t3` всегда будет равно выражению `t2 + (-t3)`, за исключением случая, когда t3 равно `timedelta.max`; в этом случае первое выражение даст результат, а второе вызовет переполнение.286287В дополнение к перечисленным выше операциям, объекты [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta) поддерживают некоторые операции сложения и вычитания с объектами [`date`](https://python-all.ru/3/library/datetime.html#datetime.date) и [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) (см. ниже).288289Изменено в версии 3.2: Теперь поддерживаются целочисленное деление и истинное деление объекта [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta) на другой объект `timedelta`, а также операции взятия остатка и функция [`divmod()`](https://python-all.ru/3/library/functions.html#divmod). Также теперь поддерживаются истинное деление и умножение объекта `timedelta` на объект [`float`](https://python-all.ru/3/library/functions.html#float).290291Объекты [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta) поддерживают сравнение на равенство и упорядочивание.292293В логических контекстах объект [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta) считается истинным тогда и только тогда, когда он не равен `timedelta(0)`.294295Методы экземпляра:296297#### `timedelta.total_seconds()`298299Возвращает общее количество секунд, содержащихся в длительности. Эквивалентно `td / timedelta(seconds=1)`. Для единиц интервала, отличных от секунд, используйте форму деления напрямую (например, `td / timedelta(microseconds=1)`).300301Обратите внимание, что для очень больших временных интервалов (более 270 лет на большинстве платформ) этот метод теряет точность до микросекунд.302303Добавлено в версии 3.2.304305### Примеры использования: `timedelta`306307Дополнительный пример нормализации:308309```python310>>> # Компоненты another_year в сумме составляют ровно 365 дней311>>> import datetime as dt312>>> year = dt.timedelta(days=365)313>>> another_year = dt.timedelta(weeks=40, days=84, hours=23,314... minutes=50, seconds=600)315>>> year == another_year316True317>>> year.total_seconds()31831536000.0319```320321Примеры арифметики [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta):322323```python324>>> import datetime as dt325>>> year = dt.timedelta(days=365)326>>> ten_years = 10 * year327>>> ten_years328datetime.timedelta(days=3650)329>>> ten_years.days // 36533010331>>> nine_years = ten_years - year332>>> nine_years333datetime.timedelta(days=3285)334>>> three_years = nine_years // 3335>>> three_years, three_years.days // 365336(datetime.timedelta(days=1095), 3)337```338339## `date` объекты340341Объект [`date`](https://python-all.ru/3/library/datetime.html#datetime.date) представляет дату (год, месяц и день) в идеализированном календаре – текущем григорианском календаре, бесконечно расширенном в обе стороны.3423431 января 1 года называется днём номер 1, 2 января 1 года – днём номер 2 и так далее. [\[2\]](https://python-all.ru/3/library/datetime.html#id5)344345#### `class datetime.date(year, month, day)`346347Все аргументы обязательны. Аргументы должны быть целыми числами в следующих диапазонах:348349- `MINYEAR <= year <= MAXYEAR`350- `1 <= month <= 12`351- `1 <= day <= number of days in the given month and year`352353Если указан аргумент вне этих диапазонов, вызывается [`ValueError`](https://python-all.ru/3/library/exceptions.html#ValueError).354355Другие конструкторы, все методы класса:356357#### `classmethod date.today()`358359Возвращает текущую локальную дату.360361Это эквивалентно `date.fromtimestamp(time.time())`.362363#### `classmethod date.fromtimestamp(timestamp)`364365Возвращает локальную дату, соответствующую POSIX *timestamp*, такую, как возвращает [`time.time()`](https://python-all.ru/3/library/time.html#time.time).366367Это может вызвать [`OverflowError`](https://python-all.ru/3/library/exceptions.html#OverflowError), если метка времени находится за пределами диапазона значений, поддерживаемого функцией C `localtime()` платформы, и [`OSError`](https://python-all.ru/3/library/exceptions.html#OSError) при ошибке `localtime()`. Обычно это ограничивается годами с 1970 по 2038. Обратите внимание, что в системах, не соответствующих POSIX, которые включают високосные секунды в своё представление метки времени, високосные секунды игнорируются функцией `fromtimestamp()`.368369Изменено в версии 3.3: Вызывается [`OverflowError`](https://python-all.ru/3/library/exceptions.html#OverflowError) вместо [`ValueError`](https://python-all.ru/3/library/exceptions.html#ValueError), если метка времени находится за пределами диапазона значений, поддерживаемого функцией C `localtime()` платформы. Вызывается [`OSError`](https://python-all.ru/3/library/exceptions.html#OSError) вместо `ValueError` при ошибке `localtime()`.370371#### `classmethod date.fromordinal(ordinal)`372373Возвращает дату, соответствующую пролептическому григорианскому *ordinal*, где 1 января 1 года имеет порядковый номер 1.374375[`ValueError`](https://python-all.ru/3/library/exceptions.html#ValueError) вызывается, если только `1 <= ordinal <= date.max.toordinal()`. Для любой даты `d`, `date.fromordinal(d.toordinal()) == d`.376377#### `classmethod date.fromisoformat(date_string)`378379Возвращает [`date`](https://python-all.ru/3/library/datetime.html#datetime.date), соответствующий *date\_string*, заданной в любом допустимом формате ISO 8601, за следующими исключениями:3803811. Даты с пониженной точностью в настоящее время не поддерживаются (`YYYY-MM`, `YYYY`).3822. Расширенные представления дат в настоящее время не поддерживаются (`±YYYYYY-MM-DD`).3833. Порядковые даты в настоящее время не поддерживаются (`YYYY-OOO`).384385Примеры:386387```python388>>> import datetime as dt389>>> dt.date.fromisoformat('2019-12-04')390datetime.date(2019, 12, 4)391>>> dt.date.fromisoformat('20191204')392datetime.date(2019, 12, 4)393>>> dt.date.fromisoformat('2021-W01-1')394datetime.date(2021, 1, 4)395```396397Добавлено в версии 3.7.398399Изменено в версии 3.11: Ранее этот метод поддерживал только формат `YYYY-MM-DD`.400401#### `classmethod date.fromisocalendar(year, week, day)`402403Возвращает [`date`](https://python-all.ru/3/library/datetime.html#datetime.date), соответствующий дате календаря ISO, указанной с помощью *year*, *week* и *day*. Это обратная функция для [`date.isocalendar()`](https://python-all.ru/3/library/datetime.html#datetime.date.isocalendar).404405Добавлено в версии 3.8.406407#### `classmethod date.strptime(date_string, format)`408409Возвращает [`date`](https://python-all.ru/3/library/datetime.html#datetime.date), соответствующий *date\_string*, разобранной в соответствии с *format*. Это эквивалентно:410411```python412date(*(time.strptime(date_string, format)[0:3]))413```414415[`ValueError`](https://python-all.ru/3/library/exceptions.html#ValueError) вызывается, если date\_string и format не могут быть разобраны [`time.strptime()`](https://python-all.ru/3/library/time.html#time.strptime) или если он возвращает значение, не являющееся кортежем времени. См. также [поведение strftime() и strptime()](https://python-all.ru/3/library/datetime.html#strftime-strptime-behavior) и [`date.fromisoformat()`](https://python-all.ru/3/library/datetime.html#datetime.date.fromisoformat).416417> **Примечание**418>419> Если *format* задаёт день месяца без года, выдаётся [`DeprecationWarning`](https://python-all.ru/3/library/exceptions.html#DeprecationWarning). Это сделано, чтобы избежать ошибки с високосным годом, которая возникает раз в четыре года, в коде, который пытается разобрать только месяц и день, так как год по умолчанию, используемый при отсутствии года в формате, не является високосным. Такие значения *format* могут вызывать ошибку, начиная с Python 3.15. Решение – всегда включать год в *format*. Если при разборе значений *date\_string*, которые не содержат года, явно добавьте год, являющийся високосным, перед разбором:420>421> ```pycon422> >>> import datetime as dt423> >>> date_string = "02/29"424> >>> when = dt.date.strptime(f"{date_string};1984", "%m/%d;%Y") # Избегает ошибки високосного года.425> >>> when.strftime("%B %d")426> 'February 29'427> ```428429Добавлено в версии 3.14.430431Атрибуты класса:432433#### `date.min`434435Самая ранняя представимая дата, `date(MINYEAR, 1, 1)`.436437#### `date.max`438439Самая поздняя представимая дата, `date(MAXYEAR, 12, 31)`.440441#### `date.resolution`442443Наименьшая возможная разница между неравными объектами дат, `timedelta(days=1)`.444445Атрибуты экземпляра (только для чтения):446447#### `date.year`448449От [`MINYEAR`](https://python-all.ru/3/library/datetime.html#datetime.MINYEAR) до [`MAXYEAR`](https://python-all.ru/3/library/datetime.html#datetime.MAXYEAR) включительно.450451#### `date.month`452453От 1 до 12 включительно.454455#### `date.day`456457От 1 до количества дней в указанном месяце указанного года.458459Поддерживаемые операции:460461| Операция | Результат |462| --- | --- |463| `date2 = date1 + timedelta` | `date2` будет на `timedelta.days` дней позже `date1`. (1) |464| `date2 = date1 - timedelta` | Вычисляет `date2` так, что `date2 + timedelta == date1`. (2) |465| `timedelta = date1 - date2` | (3) |466| `date1 == date2` `date1 != date2` | Сравнение на равенство. (4) |467| `date1 < date2` `date1 > date2` `date1 <= date2` `date1 >= date2` | Сравнение порядка. (5) |468469Примечания:4704711. *date2* сдвигается вперёд во времени, если `timedelta.days > 0`, или назад, если `timedelta.days < 0`. После этого `date2 - date1 == timedelta.days`. `timedelta.seconds` и `timedelta.microseconds` игнорируются. [`OverflowError`](https://python-all.ru/3/library/exceptions.html#OverflowError) возбуждается, если `date2.year` оказался бы меньше, чем [`MINYEAR`](https://python-all.ru/3/library/datetime.html#datetime.MINYEAR), или больше, чем [`MAXYEAR`](https://python-all.ru/3/library/datetime.html#datetime.MAXYEAR).4722. `timedelta.seconds` и `timedelta.microseconds` игнорируются.4733. Это точная операция и не может вызвать переполнение. `timedelta.seconds` и `timedelta.microseconds` равны 0, а `date2 + timedelta == date1` после.4744. Объекты [`date`](https://python-all.ru/3/library/datetime.html#datetime.date) равны, если они представляют одну и ту же дату.475476 Объекты `date`, не являющиеся также экземплярами [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime), никогда не равны объектам `datetime`, даже если они представляют одну и ту же дату.4775. *date1* считается меньше *date2*, когда *date1* предшествует *date2* во времени. Другими словами, `date1 < date2` тогда и только тогда, когда `date1.toordinal() < date2.toordinal()`.478479 Сравнение порядка между объектом [`date`](https://python-all.ru/3/library/datetime.html#datetime.date), не являющимся также экземпляром [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime), и объектом `datetime` возбуждает [`TypeError`](https://python-all.ru/3/library/exceptions.html#TypeError).480481Изменено в версии 3.13: Сравнение между объектом [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) и экземпляром подкласса [`date`](https://python-all.ru/3/library/datetime.html#datetime.date), не являющимся подклассом `datetime`, больше не преобразует последний в `date`, игнорируя часть с временем и часовой пояс. Поведение по умолчанию можно изменить, переопределив специальные методы сравнения в подклассах.482483В булевом контексте все объекты [`date`](https://python-all.ru/3/library/datetime.html#datetime.date) считаются истинными.484485Методы экземпляра:486487#### `date.replace(year=self.year, month=self.month, day=self.day)`488489Возвращает новый объект [`date`](https://python-all.ru/3/library/datetime.html#datetime.date) с теми же значениями, но с обновлёнными указанными параметрами.490491Пример:492493```python494>>> import datetime as dt495>>> d = dt.date(2002, 12, 31)496>>> d.replace(day=26)497datetime.date(2002, 12, 26)498```499500Универсальная функция [`copy.replace()`](https://python-all.ru/3/library/copy.html#copy.replace) также поддерживает объекты [`date`](https://python-all.ru/3/library/datetime.html#datetime.date).501502#### `date.timetuple()`503504Возвращает [`time.struct_time`](https://python-all.ru/3/library/time.html#time.struct_time), как возвращаемый функцией [`time.localtime()`](https://python-all.ru/3/library/time.html#time.localtime).505506Часы, минуты и секунды равны 0, а флаг DST равен -1.507508`d.timetuple()` эквивалентно:509510```python511time.struct_time((d.year, d.month, d.day, 0, 0, 0, d.weekday(), yday, -1))512```513514где `yday = d.toordinal() - date(d.year, 1, 1).toordinal() + 1` – это номер дня в текущем году, начиная с 1 для 1 января.515516#### `date.toordinal()`517518Возвращает пролептический григорианский порядковый номер даты, где 1 января 1 года имеет порядковый номер 1. Для любого объекта [`date`](https://python-all.ru/3/library/datetime.html#datetime.date) `d`, `date.fromordinal(d.toordinal()) == d`.519520#### `date.weekday()`521522Возвращает день недели в виде целого числа, где понедельник – 0, а воскресенье – 6. Например, `date(2002, 12, 4).weekday() == 2`, среда. См. также [`isoweekday()`](https://python-all.ru/3/library/datetime.html#datetime.date.isoweekday).523524#### `date.isoweekday()`525526Возвращает день недели в виде целого числа, где понедельник – 1, а воскресенье – 7. Например, `date(2002, 12, 4).isoweekday() == 3`, среда. См. также [`weekday()`](https://python-all.ru/3/library/datetime.html#datetime.date.weekday), [`isocalendar()`](https://python-all.ru/3/library/datetime.html#datetime.date.isocalendar).527528#### `date.isocalendar()`529530Возвращает объект [именованный кортеж](https://python-all.ru/3/glossary.html#term-named-tuple) с тремя компонентами: `year`, `week` и `weekday`.531532Календарь ISO – широко используемый вариант григорианского календаря. [\[3\]](https://python-all.ru/3/library/datetime.html#id6)533534Год ISO состоит из 52 или 53 полных недель, причём неделя начинается в понедельник и заканчивается в воскресенье. Первая неделя года ISO – это первая (григорианская) календарная неделя года, в которую входит четверг. Она называется неделей номер 1, и год ISO этого четверга совпадает с его григорианским годом.535536Например, 2004 год начинается в четверг, поэтому первая неделя года ISO 2004 начинается в понедельник, 29 декабря 2003 г., и заканчивается в воскресенье, 4 января 2004 г.:537538```python539>>> import datetime as dt540>>> dt.date(2003, 12, 29).isocalendar()541datetime.IsoCalendarDate(year=2004, week=1, weekday=1)542>>> dt.date(2004, 1, 4).isocalendar()543datetime.IsoCalendarDate(year=2004, week=1, weekday=7)544```545546Изменено в версии 3.9: Результат изменён с кортежа на [именованный кортеж](https://python-all.ru/3/glossary.html#term-named-tuple).547548#### `date.isoformat()`549550Возвращает строку, представляющую дату в формате ISO 8601, `YYYY-MM-DD`:551552```python553>>> import datetime as dt554>>> dt.date(2002, 12, 4).isoformat()555'2002-12-04'556```557558#### `date.__str__()`559560Для даты `d` `str(d)` эквивалентно `d.isoformat()`.561562#### `date.ctime()`563564Возвращает строку, представляющую дату:565566```python567>>> import datetime as dt568>>> dt.date(2002, 12, 4).ctime()569'Wed Dec 4 00:00:00 2002'570```571572`d.ctime()` эквивалентно:573574```python575time.ctime(time.mktime(d.timetuple()))576```577578на платформах, где нативная функция C `ctime()` (которую вызывает [`time.ctime()`](https://python-all.ru/3/library/time.html#time.ctime), но которую `date.ctime()` не вызывает) соответствует стандарту C.579580#### `date.strftime(format)`581582Возвращает строку, представляющую дату, управляемую явной строкой формата. Коды формата, относящиеся к часам, минутам или секундам, будут иметь нулевые значения. См. также [поведение strftime() и strptime()](https://python-all.ru/3/library/datetime.html#strftime-strptime-behavior) и [`date.isoformat()`](https://python-all.ru/3/library/datetime.html#datetime.date.isoformat).583584#### `date.__format__(format)`585586То же, что и [`date.strftime()`](https://python-all.ru/3/library/datetime.html#datetime.date.strftime). Это позволяет указывать строку формата для объекта [`date`](https://python-all.ru/3/library/datetime.html#datetime.date) в [форматированных строковых литералах](https://python-all.ru/3/reference/lexical_analysis.html#f-strings) и при использовании [`str.format()`](https://python-all.ru/3/library/stdtypes.html#str.format). См. также [поведение strftime() и strptime()](https://python-all.ru/3/library/datetime.html#strftime-strptime-behavior) и [`date.isoformat()`](https://python-all.ru/3/library/datetime.html#datetime.date.isoformat).587588### Примеры использования: `date`589590Пример подсчёта дней до события:591592```python593>>> import time594>>> import datetime as dt595>>> today = dt.date.today()596>>> today597datetime.date(2007, 12, 5)598>>> today == dt.date.fromtimestamp(time.time())599True600>>> my_birthday = dt.date(today.year, 6, 24)601>>> if my_birthday < today:602... my_birthday = my_birthday.replace(year=today.year + 1)603...604>>> my_birthday605datetime.date(2008, 6, 24)606>>> time_to_birthday = abs(my_birthday - today)607>>> time_to_birthday.days608202609```610611Другие примеры работы с [`date`](https://python-all.ru/3/library/datetime.html#datetime.date):612613```pycon614>>> import datetime as dt615>>> d = dt.date.fromordinal(730920) # 730920-й день после 1.1.0001616>>> d617datetime.date(2002, 3, 11)618619>>> # Методы, связанные с форматированием строкового вывода620>>> d.isoformat()621'2002-03-11'622>>> d.strftime("%d/%m/%y")623'11/03/02'624>>> d.strftime("%A %d. %B %Y")625'Monday 11. March 2002'626>>> d.ctime()627'Mon Mar 11 00:00:00 2002'628>>> 'The {1} is {0:%d}, the {2} is {0:%B}.'.format(d, "day", "month")629'The day is 11, the month is March.'630631>>> # Методы для извлечения «компонентов» в разных календарях632>>> t = d.timetuple()633>>> for i in t:634... print(i)6352002 # year6363 # month63711 # day6380639064006410 # weekday (0 = Monday)64270 # 70th day in the year643-1644>>> ic = d.isocalendar()645>>> for i in ic:646... print(i)6472002 # ISO year64811 # ISO week number6491 # ISO day number ( 1 = Monday )650651>>> # Объект date является неизменяемым; все операции создают новый объект652>>> d.replace(year=2005)653datetime.date(2005, 3, 11)654```655656## `datetime` объекты657658Объект [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) – это единый объект, содержащий всю информацию из объекта [`date`](https://python-all.ru/3/library/datetime.html#datetime.date) и объекта [`time`](https://python-all.ru/3/library/datetime.html#datetime.time).659660Как и объект [`date`](https://python-all.ru/3/library/datetime.html#datetime.date), [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) предполагает текущий григорианский календарь, расширенный в обе стороны; как и объект [`time`](https://python-all.ru/3/library/datetime.html#datetime.time), `datetime` предполагает, что в каждом дне ровно 3600\*24 секунд.661662Конструктор:663664#### `class datetime.datetime(year, month, day, hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)`665666Аргументы *year*, *month* и *day* обязательны. *tzinfo* может быть `None` или экземпляром подкласса [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo). Остальные аргументы должны быть целыми числами в следующих диапазонах:667668- `MINYEAR <= year <= MAXYEAR`,669- `1 <= month <= 12`,670- `1 <= day <= number of days in the given month and year`,671- `0 <= hour < 24`,672- `0 <= minute < 60`,673- `0 <= second < 60`,674- `0 <= microsecond < 1000000`,675- `fold in [0, 1]`.676677Если указан аргумент вне этих диапазонов, возбуждается [`ValueError`](https://python-all.ru/3/library/exceptions.html#ValueError).678679Изменено в версии 3.6: Добавлен параметр *fold*.680681Другие конструкторы – все методы класса:682683#### `classmethod datetime.today()`684685Возвращает текущие локальные дату и время, с [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo) `None`.686687Эквивалентно следующему:688689```python690datetime.fromtimestamp(time.time())691```692693См. также [`now()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.now), [`fromtimestamp()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.fromtimestamp).694695Этот метод функционально эквивалентен [`now()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.now), но без параметра `tz`.696697#### `classmethod datetime.now(tz=None)`698699Возвращает текущие локальные дату и время.700701Если необязательный аргумент *tz* равен `None` или не указан, это аналогично [`today()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.today), но, по возможности, обеспечивает большую точность, чем можно получить через метку времени [`time.time()`](https://python-all.ru/3/library/time.html#time.time) (например, это возможно на платформах, предоставляющих функцию C `gettimeofday()`).702703Если *tz* не равен `None`, он должен быть экземпляром подкласса [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo), а текущие дата и время преобразуются в часовой пояс *tz*.704705Эта функция предпочтительнее [`today()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.today) и [`utcnow()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.utcnow).706707> **Примечание**708>709> Последующие вызовы `datetime.now()` могут возвращать один и тот же момент времени в зависимости от точности базовых часов.710711#### `classmethod datetime.utcnow()`712713Возвращает текущие дату и время UTC, с [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo) `None`.714715Это похоже на [`now()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.now), но возвращает текущие дату и время UTC в виде наивного объекта [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime). Осведомлённый объект текущего времени UTC можно получить, вызвав `datetime.now(timezone.utc)`. См. также `now()`.716717> **Предупреждение**718>719> Поскольку наивные объекты `datetime` многими методами `datetime` рассматриваются как местное время, для представления времени в UTC предпочтительнее использовать осведомлённые объекты datetime. Поэтому рекомендуемый способ создания объекта, представляющего текущее время в UTC, – вызов `datetime.now(timezone.utc)`.720721Устарело с версии 3.12: Вместо этого используйте [`datetime.now()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.now) с [`UTC`](https://python-all.ru/3/library/datetime.html#datetime.UTC).722723#### `classmethod datetime.fromtimestamp(timestamp, tz=None)`724725Возвращает локальные дату и время, соответствующие метке времени POSIX, такой как возвращается [`time.time()`](https://python-all.ru/3/library/time.html#time.time). Если необязательный аргумент *tz* равен `None` или не указан, метка времени преобразуется в локальные дату и время платформы, и возвращаемый объект [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) является наивным.726727Если *tz* не равен `None`, он должен быть экземпляром подкласса [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo), и метка времени преобразуется в часовой пояс *tz*.728729`fromtimestamp()` может возбуждать [`OverflowError`](https://python-all.ru/3/library/exceptions.html#OverflowError), если метка времени выходит за диапазон значений, поддерживаемых платформенными функциями C `localtime()` или `gmtime()`, и [`OSError`](https://python-all.ru/3/library/exceptions.html#OSError) при ошибке `localtime()` или `gmtime()`. Обычно это ограничено годами с 1970 по 2038. Обратите внимание, что на системах, не совместимых с POSIX, которые включают високосные секунды в своё представление метки времени, високосные секунды игнорируются `fromtimestamp()`, и поэтому возможно иметь две метки времени, различающиеся на секунду, которые дают идентичные объекты [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime). Этот метод предпочтительнее [`utcfromtimestamp()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.utcfromtimestamp).730731Изменено в версии 3.3: Возбуждает [`OverflowError`](https://python-all.ru/3/library/exceptions.html#OverflowError) вместо [`ValueError`](https://python-all.ru/3/library/exceptions.html#ValueError), если метка времени выходит за диапазон значений, поддерживаемых платформенными функциями C `localtime()` или `gmtime()`. Возбуждает [`OSError`](https://python-all.ru/3/library/exceptions.html#OSError) вместо `ValueError` при ошибке `localtime()` или `gmtime()`.732733Изменено в версии 3.6: `fromtimestamp()` может возвращать экземпляры с [`fold`](https://python-all.ru/3/library/datetime.html#datetime.datetime.fold), установленным в 1.734735#### `classmethod datetime.utcfromtimestamp(timestamp)`736737Возвращает [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) UTC, соответствующий метке времени POSIX, с [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo) `None`. (Результирующий объект является наивным.)738739Это может возбуждать [`OverflowError`](https://python-all.ru/3/library/exceptions.html#OverflowError), если метка времени выходит за диапазон значений, поддерживаемых платформенной функцией C `gmtime()`, и [`OSError`](https://python-all.ru/3/library/exceptions.html#OSError) при ошибке `gmtime()`. Обычно это ограничено годами с 1970 по 2038.740741Чтобы получить осведомлённый объект [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime), вызовите [`fromtimestamp()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.fromtimestamp):742743```python744datetime.fromtimestamp(timestamp, timezone.utc)745```746747На платформах, совместимых с POSIX, это эквивалентно следующему выражению:748749```python750datetime(1970, 1, 1, tzinfo=timezone.utc) + timedelta(seconds=timestamp)751```752753за исключением того, что последняя формула всегда поддерживает полный диапазон лет: от [`MINYEAR`](https://python-all.ru/3/library/datetime.html#datetime.MINYEAR) до [`MAXYEAR`](https://python-all.ru/3/library/datetime.html#datetime.MAXYEAR) включительно.754755> **Предупреждение**756>757> Поскольку наивные объекты `datetime` во многих методах `datetime` трактуются как местное время, для представления времени в UTC предпочтительнее использовать aware-даты. Поэтому рекомендуемый способ создания объекта для конкретной метки времени в UTC – вызов `datetime.fromtimestamp(timestamp, tz=timezone.utc)`.758759Изменено в версии 3.3: Вызывает [`OverflowError`](https://python-all.ru/3/library/exceptions.html#OverflowError) вместо [`ValueError`](https://python-all.ru/3/library/exceptions.html#ValueError), если метка времени выходит за пределы диапазона значений, поддерживаемого функцией `gmtime()` платформы C. Вызывает [`OSError`](https://python-all.ru/3/library/exceptions.html#OSError) вместо `ValueError` при ошибке `gmtime()`.760761Изменено в версии 3.15: Принимает любое действительное число в качестве *timestamp*, а не только целое или число с плавающей запятой.762763Устарело с версии 3.12: Вместо этого используйте [`datetime.fromtimestamp()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.fromtimestamp) с [`UTC`](https://python-all.ru/3/library/datetime.html#datetime.UTC).764765#### `classmethod datetime.fromordinal(ordinal)`766767Возвращает [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime), соответствующий пролептическому григорианскому порядковому номеру, где 1 января 1 года имеет порядковый номер 1. [`ValueError`](https://python-all.ru/3/library/exceptions.html#ValueError) вызывается, если не выполнено `1 <= ordinal <= datetime.max.toordinal()`. Час, минута, секунда и микросекунда результата равны 0, а [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo) равен `None`.768769#### `classmethod datetime.combine(date, time, tzinfo=time.tzinfo)`770771Возвращает новый объект [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime), компоненты даты которого равны компонентам заданного объекта [`date`](https://python-all.ru/3/library/datetime.html#datetime.date), а компоненты времени равны компонентам заданного объекта [`time`](https://python-all.ru/3/library/datetime.html#datetime.time). Если указан аргумент *tzinfo*, его значение используется для установки атрибута [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo) результата, в противном случае используется атрибут [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.time.tzinfo) аргумента *time*. Если аргумент *date* является объектом `datetime`, его компоненты времени и атрибуты `tzinfo` игнорируются.772773Для любого объекта [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) `d`, `d == datetime.combine(d.date(), d.time(), d.tzinfo)`.774775Изменено в версии 3.6: Добавлен аргумент *tzinfo*.776777#### `classmethod datetime.fromisoformat(date_string)`778779Возвращает [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime), соответствующий строке *date\_string* в любом допустимом формате ISO 8601, за следующими исключениями:7807811. Отклонения часового пояса могут содержать доли секунды.7822. Разделитель `T` может быть заменён любым отдельным символом Unicode.7833. Дробные часы и минуты не поддерживаются.7844. Даты с пониженной точностью в настоящее время не поддерживаются (`YYYY-MM`, `YYYY`).7855. Расширенные представления дат в настоящее время не поддерживаются (`±YYYYYY-MM-DD`).7866. Порядковые даты в настоящее время не поддерживаются (`YYYY-OOO`).787788Примеры:789790```python791>>> import datetime as dt792>>> dt.datetime.fromisoformat('2011-11-04')793datetime.datetime(2011, 11, 4, 0, 0)794>>> dt.datetime.fromisoformat('20111104')795datetime.datetime(2011, 11, 4, 0, 0)796>>> dt.datetime.fromisoformat('2011-11-04T00:05:23')797datetime.datetime(2011, 11, 4, 0, 5, 23)798>>> dt.datetime.fromisoformat('2011-11-04T00:05:23Z')799datetime.datetime(2011, 11, 4, 0, 5, 23, tzinfo=datetime.timezone.utc)800>>> dt.datetime.fromisoformat('20111104T000523')801datetime.datetime(2011, 11, 4, 0, 5, 23)802>>> dt.datetime.fromisoformat('2011-W01-2T00:05:23.283')803datetime.datetime(2011, 1, 4, 0, 5, 23, 283000)804>>> dt.datetime.fromisoformat('2011-11-04 00:05:23.283')805datetime.datetime(2011, 11, 4, 0, 5, 23, 283000)806>>> dt.datetime.fromisoformat('2011-11-04 00:05:23.283+00:00')807datetime.datetime(2011, 11, 4, 0, 5, 23, 283000, tzinfo=datetime.timezone.utc)808>>> dt.datetime.fromisoformat('2011-11-04T00:05:23+04:00')809datetime.datetime(2011, 11, 4, 0, 5, 23,810 tzinfo=datetime.timezone(datetime.timedelta(seconds=14400)))811```812813Добавлено в версии 3.7.814815Изменено в версии 3.11: Ранее этот метод поддерживал только форматы, которые могли быть созданы с помощью [`date.isoformat()`](https://python-all.ru/3/library/datetime.html#datetime.date.isoformat) или [`datetime.isoformat()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.isoformat).816817#### `classmethod datetime.fromisocalendar(year, week, day)`818819Возвращает [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime), соответствующий дате по ISO-календарю, заданной *year*, *week* и *day*. Компоненты datetime, не связанные с датой, заполняются обычными значениями по умолчанию. Это обратная функция от [`datetime.isocalendar()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.isocalendar).820821Добавлено в версии 3.8.822823#### `classmethod datetime.strptime(date_string, format)`824825Возвращает [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime), соответствующий *date\_string*, разобранной в соответствии с *format*.826827Если *format* не содержит микросекунд или информации о часовом поясе, это эквивалентно:828829```python830datetime(*(time.strptime(date_string, format)[0:6]))831```832833[`ValueError`](https://python-all.ru/3/library/exceptions.html#ValueError) вызывается, если date\_string и format не могут быть разобраны с помощью [`time.strptime()`](https://python-all.ru/3/library/time.html#time.strptime), или если возвращается значение, не являющееся временным кортежем. См. также [поведение strftime() и strptime()](https://python-all.ru/3/library/datetime.html#strftime-strptime-behavior) и [`datetime.fromisoformat()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.fromisoformat).834835Изменено в версии 3.13: Если в *format* указан день месяца без года, теперь выдаётся [`DeprecationWarning`](https://python-all.ru/3/library/exceptions.html#DeprecationWarning). Это необходимо для избежания четырёхлетней ошибки, связанной с високосным годом, в коде, который пытается разобрать только месяц и день, поскольку год по умолчанию, используемый при отсутствии года в формате, не является високосным. Такие значения *format* могут вызывать ошибку начиная с Python 3.15. Решение – всегда включать год в *format*. При разборе значений *date\_string*, не содержащих года, перед разбором явно добавьте год, который является високосным:836837```pycon838>>> import datetime as dt839>>> date_string = "02/29"840>>> when = dt.datetime.strptime(f"{date_string};1984", "%m/%d;%Y") # Избегает ошибки високосного года.841>>> when.strftime("%B %d")842'February 29'843```844845Атрибуты класса:846847#### `datetime.min`848849Самая ранняя представимая [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime), `datetime(MINYEAR, 1, 1, tzinfo=None)`.850851#### `datetime.max`852853Последний представимый [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime), `datetime(MAXYEAR, 12, 31, 23, 59, 59, 999999, tzinfo=None)`.854855#### `datetime.resolution`856857Наименьшая возможная разница между неравными [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) объектами, `timedelta(microseconds=1)`.858859Атрибуты экземпляра (только для чтения):860861#### `datetime.year`862863От [`MINYEAR`](https://python-all.ru/3/library/datetime.html#datetime.MINYEAR) до [`MAXYEAR`](https://python-all.ru/3/library/datetime.html#datetime.MAXYEAR) включительно.864865#### `datetime.month`866867От 1 до 12 включительно.868869#### `datetime.day`870871От 1 до количества дней в указанном месяце указанного года.872873#### `datetime.hour`874875В `range(24)`.876877#### `datetime.minute`878879В `range(60)`.880881#### `datetime.second`882883В `range(60)`.884885#### `datetime.microsecond`886887В `range(1000000)`.888889#### `datetime.tzinfo`890891Объект, переданный в качестве аргумента *tzinfo* конструктору [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime), или `None`, если ничего не было передано.892893#### `datetime.fold`894895В `[0, 1]`. Используется для разрешения неоднозначности местного времени в повторяющемся интервале. (Повторяющийся интервал возникает, когда часы переводятся назад в конце летнего времени или когда смещение UTC для текущей зоны уменьшается по политическим причинам.) Значения 0 и 1 представляют соответственно более ранний и более поздний моменты из двух с одинаковым местным временем.896897Добавлено в версии 3.6.898899Поддерживаемые операции:900901| Операция | Результат |902| --- | --- |903| `datetime2 = datetime1 + timedelta` | (1) |904| `datetime2 = datetime1 - timedelta` | (2) |905| `timedelta = datetime1 - datetime2` | (3) |906| `datetime1 == datetime2` `datetime1 != datetime2` | Сравнение на равенство. (4) |907| `datetime1 < datetime2` `datetime1 > datetime2` `datetime1 <= datetime2` `datetime1 >= datetime2` | Сравнение порядка. (5) |9089091. `datetime2` – это длительность `timedelta`, вычитаемая из `datetime1`, сдвигающая время вперёд, если `timedelta.days > 0`, или назад, если `timedelta.days < 0`. Результат имеет тот же атрибут [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo), что и исходный datetime, и `datetime2 - datetime1 == timedelta` после. [`OverflowError`](https://python-all.ru/3/library/exceptions.html#OverflowError) возникает, если `datetime2.year` окажется меньше [`MINYEAR`](https://python-all.ru/3/library/datetime.html#datetime.MINYEAR) или больше [`MAXYEAR`](https://python-all.ru/3/library/datetime.html#datetime.MAXYEAR). Обратите внимание, что корректировка часового пояса не выполняется, даже если исходный объект осведомлён.9102. Вычисляет `datetime2`, такой что `datetime2 + timedelta == datetime1`. Как и при сложении, результат имеет тот же атрибут [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo), что и исходный datetime, и корректировка часового пояса не выполняется, даже если исходный объект осведомлён.9113. Вычитание [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) из `datetime` определено только если оба операнда наивны или оба осведомлены. Если один осведомлён, а другой наивен, возникает [`TypeError`](https://python-all.ru/3/library/exceptions.html#TypeError).912913 Если оба наивны, или оба осведомлены и имеют одинаковый атрибут [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo), атрибуты `tzinfo` игнорируются, и результатом является объект [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta) `t`, такой что `datetime2 + t == datetime1`. В этом случае корректировка часового пояса не выполняется.914915 Если оба осведомлены и имеют разные атрибуты [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo), `a-b` действует так, как если бы `a` и `b` были сначала преобразованы в наивные объекты datetime в UTC. Результат – `(a.replace(tzinfo=None) - a.utcoffset()) - (b.replace(tzinfo=None) - b.utcoffset())`, за исключением того, что в реализации никогда не возникает переполнения.9164. Объекты [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) равны, если они представляют одну и ту же дату и время с учётом часового пояса.917918 Наивные и осознающие объекты [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) никогда не равны.919920 Если оба операнда осознающие и имеют одинаковый атрибут `tzinfo`, атрибуты `tzinfo` и [`fold`](https://python-all.ru/3/library/datetime.html#datetime.datetime.fold) игнорируются, и сравниваются базовые даты и время. Если оба операнда осознающие и имеют разные атрибуты [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo), сравнение ведётся так, как если бы операнды сначала были преобразованы в даты и время в UTC, за исключением того, что реализация никогда не вызывает переполнение. Экземпляры [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) в повторяющемся интервале никогда не равны экземплярам `datetime` в другом часовом поясе.9215. *datetime1* считается меньше *datetime2*, когда *datetime1* предшествует *datetime2* во времени с учётом часового пояса.922923 Операция сравнения порядка между наивными и осознающими объектами [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) вызывает [`TypeError`](https://python-all.ru/3/library/exceptions.html#TypeError).924925 Если оба операнда осознающие и имеют одинаковый атрибут `tzinfo`, атрибуты `tzinfo` и [`fold`](https://python-all.ru/3/library/datetime.html#datetime.datetime.fold) игнорируются, и сравниваются базовые даты и время. Если оба операнда осознающие и имеют разные атрибуты [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo), сравнение ведётся так, как если бы операнды сначала были преобразованы в даты и время в UTC, за исключением того, что реализация никогда не вызывает переполнение.926927Изменено в версии 3.3: Сравнения на равенство между осознающими и наивными экземплярами [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) не вызывают [`TypeError`](https://python-all.ru/3/library/exceptions.html#TypeError).928929Изменено в версии 3.13: Сравнение между объектом [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) и экземпляром подкласса [`date`](https://python-all.ru/3/library/datetime.html#datetime.date), который не является подклассом `datetime`, больше не преобразует последний в `date`, игнорируя временную часть и часовой пояс. Поведение по умолчанию можно изменить, переопределив специальные методы сравнения в подклассах.930931Методы экземпляра:932933#### `datetime.date()`934935Возвращает объект [`date`](https://python-all.ru/3/library/datetime.html#datetime.date) с тем же годом, месяцем и днём.936937#### `datetime.time()`938939Возвращает объект [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) с теми же часами, минутами, секундами, микросекундами и fold. [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo) равно `None`. См. также метод [`timetz()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.timetz).940941Изменено в версии 3.6: Значение fold копируется в возвращаемый объект [`time`](https://python-all.ru/3/library/datetime.html#datetime.time).942943#### `datetime.timetz()`944945Возвращает объект [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) с теми же атрибутами hour, minute, second, microsecond, fold и tzinfo. См. также метод [`time()`](https://python-all.ru/3/library/time.html#module-time).946947Изменено в версии 3.6: Значение fold копируется в возвращаемый объект [`time`](https://python-all.ru/3/library/datetime.html#datetime.time).948949#### `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)`950951Возвращает новый объект [`datetime`](https://python-all.ru/3/library/datetime.html#module-datetime) с теми же атрибутами, но с обновлёнными указанными параметрами. Обратите внимание, что `tzinfo=None` можно указать, чтобы создать наивный datetime из осознающего без преобразования данных даты и времени.952953Объекты [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) также поддерживаются обобщённой функцией [`copy.replace()`](https://python-all.ru/3/library/copy.html#copy.replace).954955Изменено в версии 3.6: Добавлен параметр *fold*.956957#### `datetime.astimezone(tz=None)`958959Возвращает объект [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) с новым атрибутом [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo) *tz*, корректируя данные даты и времени так, чтобы результат соответствовал тому же времени UTC, что и *self*, но в местном времени *tz*.960961Если *tz* указан, он должен быть экземпляром подкласса [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo), а его методы [`utcoffset()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.utcoffset) и [`dst()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.dst) не должны возвращать `None`. Если *self* наивный, предполагается, что он представляет время в системном часовом поясе.962963Если вызывается без аргументов (или с `tz=None`), для целевого часового пояса используется системный местный часовой пояс. Атрибут `.tzinfo` преобразованного экземпляра datetime будет установлен в экземпляр [`timezone`](https://python-all.ru/3/library/datetime.html#datetime.timezone) с именем зоны и смещением, полученными от ОС.964965Если `self.tzinfo` равно *tz*, `self.astimezone(tz)` равно *self*: корректировка данных даты или времени не выполняется. В противном случае результат – местное время в часовом поясе *tz*, представляющее то же время UTC, что и *self*: после `astz = dt.astimezone(tz)` `astz - astz.utcoffset()` будут содержать те же данные даты и времени, что и `dt - dt.utcoffset()`.966967Если нужно просто прикрепить объект [`timezone`](https://python-all.ru/3/library/datetime.html#datetime.timezone) *tz* к datetime *dt* без корректировки данных даты и времени, используйте `dt.replace(tzinfo=tz)`. Если нужно просто удалить объект `timezone` из осознающего datetime *dt* без преобразования данных даты и времени, используйте `dt.replace(tzinfo=None)`.968969Обратите внимание, что метод по умолчанию [`tzinfo.fromutc()`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo.fromutc) можно переопределить в подклассе [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo), чтобы повлиять на результат, возвращаемый `astimezone()`. Если не учитывать ошибки, `astimezone()` работает следующим образом:970971```python972def astimezone(self, tz):973 if self.tzinfo is tz:974 return self975 # Преобразует self в UTC и присоединяет новый объект часового пояса.976 utc = (self - self.utcoffset()).replace(tzinfo=tz)977 # Преобразует из UTC в местное время tz.978 return tz.fromutc(utc)979```980981Изменено в версии 3.3: *tz* теперь можно опускать.982983Изменено в версии 3.6: Метод `astimezone()` теперь можно вызывать для наивных экземпляров, которые считаются представляющими системное местное время.984985#### `datetime.utcoffset()`986987Если [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo) равно `None`, возвращает `None`, иначе возвращает `self.tzinfo.utcoffset(self)` и вызывает исключение, если последний не возвращает `None` или объект [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta) с величиной менее одного дня.988989Изменено в версии 3.7: Смещение UTC не ограничено целым числом минут.990991#### `datetime.dst()`992993Если [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo) равно `None`, возвращается `None`, иначе возвращается `self.tzinfo.dst(self)`, и возбуждается исключение, если последний не возвращает `None` или объект [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta) с величиной меньше одного дня.994995Изменено в версии 3.7: Смещение DST не ограничено целым числом минут.996997#### `datetime.tzname()`998999Если [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo) равно `None`, возвращается `None`, иначе возвращается `self.tzinfo.tzname(self)`, возбуждается исключение, если последний не возвращает `None` или строковый объект,10001001#### `datetime.timetuple()`10021003Возвращает [`time.struct_time`](https://python-all.ru/3/library/time.html#time.struct_time) такой, какой возвращается [`time.localtime()`](https://python-all.ru/3/library/time.html#time.localtime).10041005`d.timetuple()` эквивалентно:10061007```python1008time.struct_time((d.year, d.month, d.day,1009 d.hour, d.minute, d.second,1010 d.weekday(), yday, dst))1011```10121013где `yday = d.toordinal() - date(d.year, 1, 1).toordinal() + 1` – номер дня в текущем году, начиная с 1 для 1 января. Флаг [`tm_isdst`](https://python-all.ru/3/library/time.html#time.struct_time.tm_isdst) результата устанавливается в соответствии с методом [`dst()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.dst): если [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo) равно `None` или `dst()` возвращает `None`, `tm_isdst` устанавливается в `-1`; иначе, если `dst()` возвращает ненулевое значение, `tm_isdst` устанавливается в 1; иначе `tm_isdst` устанавливается в 0.10141015#### `datetime.utctimetuple()`10161017Если экземпляр [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) `d` наивный, это то же самое, что `d.timetuple()`, за исключением того, что [`tm_isdst`](https://python-all.ru/3/library/time.html#time.struct_time.tm_isdst) принудительно устанавливается в 0 независимо от того, что возвращает `d.dst()`. DST никогда не действует для времени UTC.10181019Если `d` осознанный, `d` нормализуется к времени UTC вычитанием `d.utcoffset()`, и возвращается [`time.struct_time`](https://python-all.ru/3/library/time.html#time.struct_time) для нормализованного времени. `tm_isdst` принудительно устанавливается в 0. Обратите внимание, что может быть возбуждено [`OverflowError`](https://python-all.ru/3/library/exceptions.html#OverflowError), если `d.year` было `MINYEAR` или `MAXYEAR` и корректировка UTC выходит за границу года.10201021> **Предупреждение**1022>1023> Поскольку наивные объекты `datetime` рассматриваются многими методами `datetime` как местное время, предпочтительнее использовать осознанные объекты datetime для представления времени в UTC; как результат, использование `datetime.utctimetuple()` может давать вводящие в заблуждение результаты. Если у вас есть наивный `datetime`, представляющий UTC, используйте `datetime.replace(tzinfo=timezone.utc)`, чтобы сделать его осознанным, после чего можно использовать [`datetime.timetuple()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.timetuple).10241025#### `datetime.toordinal()`10261027Возвращает пролептический григорианский порядковый номер даты. То же, что `self.date().toordinal()`.10281029#### `datetime.timestamp()`10301031Возвращает временную метку POSIX, соответствующую экземпляру [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime). Возвращаемое значение – [`float`](https://python-all.ru/3/library/functions.html#float), похожее на то, что возвращается [`time.time()`](https://python-all.ru/3/library/time.html#time.time).10321033Наивные экземпляры [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) считаются представляющими местное время, и этот метод полагается на функцию C `mktime()` платформы для выполнения преобразования. Поскольку `datetime` поддерживает более широкий диапазон значений, чем `mktime()` на многих платформах, этот метод может возбуждать [`OverflowError`](https://python-all.ru/3/library/exceptions.html#OverflowError) или [`OSError`](https://python-all.ru/3/library/exceptions.html#OSError) для моментов времени в далёком прошлом или далёком будущем.10341035Для осознанных экземпляров [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) возвращаемое значение вычисляется как:10361037```python1038(dt - datetime(1970, 1, 1, tzinfo=timezone.utc)).total_seconds()1039```10401041> **Примечание**1042>1043> Нет метода для получения временной метки POSIX непосредственно из наивного экземпляра [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime), представляющего время UTC. Если ваше приложение использует это соглашение и часовой пояс вашей системы не установлен на UTC, вы можете получить временную метку POSIX, указав `tzinfo=timezone.utc`:1044>1045> ```python1046> timestamp = dt.replace(tzinfo=timezone.utc).timestamp()1047> ```1048>1049> или вычислив метку напрямую:1050>1051> ```python1052> timestamp = (dt - datetime(1970, 1, 1)) / timedelta(seconds=1)1053> ```10541055Добавлено в версии 3.3.10561057Изменено в версии 3.6: Метод `timestamp()` использует атрибут [`fold`](https://python-all.ru/3/library/datetime.html#datetime.datetime.fold) для устранения неоднозначности моментов времени в течение повторяющегося интервала.10581059#### `datetime.weekday()`10601061Возвращает день недели в виде целого числа, где понедельник – 0, а воскресенье – 6. То же, что `self.date().weekday()`. См. также [`isoweekday()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.isoweekday).10621063#### `datetime.isoweekday()`10641065Возвращает день недели в виде целого числа, где понедельник – 1, а воскресенье – 7. То же, что `self.date().isoweekday()`. См. также [`weekday()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.weekday), [`isocalendar()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.isocalendar).10661067#### `datetime.isocalendar()`10681069Возвращает [именованный кортеж](https://python-all.ru/3/glossary.html#term-named-tuple) с тремя компонентами: `year`, `week` и `weekday`. То же, что `self.date().isocalendar()`.10701071#### `datetime.isoformat(sep='T', timespec='auto')`10721073Возвращает строку, представляющую дату и время в формате ISO 8601:10741075- `YYYY-MM-DDTHH:MM:SS.ffffff`, если [`microsecond`](https://python-all.ru/3/library/datetime.html#datetime.datetime.microsecond) не равно 01076- `YYYY-MM-DDTHH:MM:SS`, если [`microsecond`](https://python-all.ru/3/library/datetime.html#datetime.datetime.microsecond) равно 010771078Если [`utcoffset()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.utcoffset) не возвращает `None`, добавляется строка с указанием смещения UTC:10791080- `YYYY-MM-DDTHH:MM:SS.ffffff+HH:MM[:SS[.ffffff]]`, если [`microsecond`](https://python-all.ru/3/library/datetime.html#datetime.datetime.microsecond) не равно 01081- `YYYY-MM-DDTHH:MM:SS+HH:MM[:SS[.ffffff]]`, если [`microsecond`](https://python-all.ru/3/library/datetime.html#datetime.datetime.microsecond) равно 010821083Примеры:10841085```python1086>>> import datetime as dt1087>>> dt.datetime(2019, 5, 18, 15, 17, 8, 132263).isoformat()1088'2019-05-18T15:17:08.132263'1089>>> dt.datetime(2019, 5, 18, 15, 17, tzinfo=dt.timezone.utc).isoformat()1090'2019-05-18T15:17:00+00:00'1091```10921093Необязательный аргумент *sep* (по умолчанию `'T'`) – это односимвольный разделитель, который ставится между частями даты и времени результата. Например:10941095```python1096>>> import datetime as dt1097>>> class TZ(dt.tzinfo):1098... """Часовой пояс с произвольным постоянным смещением -06:39."""1099... def utcoffset(self, when):1100... return dt.timedelta(hours=-6, minutes=-39)1101...1102>>> dt.datetime(2002, 12, 25, tzinfo=TZ()).isoformat(' ')1103'2002-12-25 00:00:00-06:39'1104>>> dt.datetime(2009, 11, 27, microsecond=100, tzinfo=TZ()).isoformat()1105'2009-11-27T00:00:00.000100-06:39'1106```11071108Необязательный аргумент *timespec* задаёт количество дополнительных составляющих времени, которые нужно включить (по умолчанию `'auto'`). Он может принимать одно из следующих значений:11091110- `'auto'`: то же, что `'seconds'`, если [`microsecond`](https://python-all.ru/3/library/datetime.html#datetime.datetime.microsecond) равно 0, иначе то же, что `'microseconds'`.1111- `'hours'`: включает [`hour`](https://python-all.ru/3/library/datetime.html#datetime.datetime.hour) в двузначном формате `HH`.1112- `'minutes'`: включает [`hour`](https://python-all.ru/3/library/datetime.html#datetime.datetime.hour) и [`minute`](https://python-all.ru/3/library/datetime.html#datetime.datetime.minute) в формате `HH:MM`.1113- `'seconds'`: включает [`hour`](https://python-all.ru/3/library/datetime.html#datetime.datetime.hour), [`minute`](https://python-all.ru/3/library/datetime.html#datetime.datetime.minute) и [`second`](https://python-all.ru/3/library/datetime.html#datetime.datetime.second) в формате `HH:MM:SS`.1114- `'milliseconds'`: включает полное время, но обрезает долю секунды до миллисекунд. Формат `HH:MM:SS.sss`.1115- `'microseconds'`: включает полное время в формате `HH:MM:SS.ffffff`.11161117> **Примечание**1118>1119> Исключённые временны́е компоненты обрезаются, а не округляются.11201121[`ValueError`](https://python-all.ru/3/library/exceptions.html#ValueError) будет возбуждено при недопустимом значении аргумента *timespec*:11221123```python1124>>> import datetime as dt1125>>> dt.datetime.now().isoformat(timespec='minutes')1126'2002-12-25T00:00'1127>>> my_datetime = dt.datetime(2015, 1, 1, 12, 30, 59, 0)1128>>> my_datetime.isoformat(timespec='microseconds')1129'2015-01-01T12:30:59.000000'1130```11311132Изменено в версии 3.6: добавлен параметр *timespec*.11331134#### `datetime.__str__()`11351136Для экземпляра [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) `d` `str(d)` эквивалентно `d.isoformat(' ')`.11371138#### `datetime.ctime()`11391140Возвращает строку, представляющую дату и время:11411142```python1143>>> import datetime as dt1144>>> dt.datetime(2002, 12, 4, 20, 30, 40).ctime()1145'Wed Dec 4 20:30:40 2002'1146```11471148Результирующая строка *не* содержит информацию о часовом поясе независимо от того, является ли исходный объект aware или naive.11491150`d.ctime()` эквивалентно:11511152```python1153time.ctime(time.mktime(d.timetuple()))1154```11551156на платформах, где нативная C-функция `ctime()` (которая вызывается в [`time.ctime()`](https://python-all.ru/3/library/time.html#time.ctime), но не вызывается в `datetime.ctime()`) соответствует стандарту C.11571158#### `datetime.strftime(format)`11591160Возвращает строку, представляющую дату и время, с управлением через явную строку форматирования. См. также [Поведение strftime() и strptime()](https://python-all.ru/3/library/datetime.html#strftime-strptime-behavior) и [`datetime.isoformat()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.isoformat).11611162#### `datetime.__format__(format)`11631164То же, что [`datetime.strftime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strftime). Это позволяет задавать строку форматирования для объекта [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) в [форматированных строковых литералах](https://python-all.ru/3/reference/lexical_analysis.html#f-strings) и при использовании [`str.format()`](https://python-all.ru/3/library/stdtypes.html#str.format). См. также [Поведение strftime() и strptime()](https://python-all.ru/3/library/datetime.html#strftime-strptime-behavior) и [`datetime.isoformat()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.isoformat).11651166### Примеры использования: `datetime`11671168Примеры работы с объектами [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime):11691170```pycon1171>>> import datetime as dt11721173>>> # Использование datetime.combine()1174>>> d = dt.date(2005, 7, 14)1175>>> t = dt.time(12, 30)1176>>> dt.datetime.combine(d, t)1177datetime.datetime(2005, 7, 14, 12, 30)11781179>>> # Использование datetime.now()1180>>> dt.datetime.now()1181datetime.datetime(2007, 12, 6, 16, 29, 43, 79043) # GMT +11182>>> dt.datetime.now(dt.timezone.utc)1183datetime.datetime(2007, 12, 6, 15, 29, 43, 79060, tzinfo=datetime.timezone.utc)11841185>>> # Использование datetime.strptime()1186>>> my_datetime = dt.datetime.strptime("21/11/06 16:30", "%d/%m/%y %H:%M")1187>>> my_datetime1188datetime.datetime(2006, 11, 21, 16, 30)11891190>>> # Использование datetime.timetuple() для получения кортежа всех атрибутов1191>>> tt = my_datetime.timetuple()1192>>> for it in tt:1193... print(it)1194...11952006 # year119611 # month119721 # day119816 # hour119930 # minute12000 # second12011 # weekday (0 = Monday)1202325 # number of days since 1st January1203-1 # dst - method tzinfo.dst() returned None12041205>>> # Дата в формате ISO1206>>> ic = my_datetime.isocalendar()1207>>> for it in ic:1208... print(it)1209...12102006 # ISO year121147 # ISO week12122 # ISO weekday12131214>>> # Форматирование datetime1215>>> my_datetime.strftime("%A, %d. %B %Y %I:%M%p")1216'Tuesday, 21. November 2006 04:30PM'1217>>> 'The {1} is {0:%d}, the {2} is {0:%B}, the {3} is {0:%I:%M%p}.'.format(my_datetime, "day", "month", "time")1218'The day is 21, the month is November, the time is 04:30PM.'1219```12201221В приведённом ниже примере определяется подкласс [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo), который фиксирует информацию о часовом поясе для Кабула (Афганистан). До 1945 года там использовалось смещение +4 UTC, а затем +4:30 UTC:12221223```python1224import datetime as dt12251226class KabulTz(dt.tzinfo):1227 # В Кабуле до 1945 года использовали +4, затем перешли на +4:301228 UTC_MOVE_DATE = dt.datetime(1944, 12, 31, 20, tzinfo=dt.timezone.utc)12291230 def utcoffset(self, when):1231 if when.year < 1945:1232 return dt.timedelta(hours=4)1233 elif (1945, 1, 1, 0, 0) <= when.timetuple()[:5] < (1945, 1, 1, 0, 30):1234 # Неоднозначный («мнимый») получасовой диапазон, представляющий1235 # «складку» во времени из-за перехода с +4 на +4:30.1236 # Если when попадает в мнимый диапазон, используйте fold, чтобы решить, как1237 # разрешить неоднозначность. См. PEP 495.1238 return dt.timedelta(hours=4, minutes=(30 if when.fold else 0))1239 else:1240 return dt.timedelta(hours=4, minutes=30)12411242 def fromutc(self, when):1243 # Следуйте тем же проверкам, что и в datetime.tzinfo1244 if not isinstance(when, dt.datetime):1245 raise TypeError("fromutc() requires a datetime argument")1246 if when.tzinfo is not self:1247 raise ValueError("when.tzinfo is not self")12481249 # Для fromutc требуется собственная реализация, так как1250 # входные данные для этой функции – это datetime со значениями UTC1251 # но с tzinfo, установленным на self.1252 # См. datetime.astimezone или fromtimestamp.1253 if when.replace(tzinfo=dt.timezone.utc) >= self.UTC_MOVE_DATE:1254 return when + dt.timedelta(hours=4, minutes=30)1255 else:1256 return when + dt.timedelta(hours=4)12571258 def dst(self, when):1259 # В Кабуле не соблюдается летнее время.1260 return dt.timedelta(0)12611262 def tzname(self, when):1263 if when >= self.UTC_MOVE_DATE:1264 return "+04:30"1265 return "+04"1266```12671268Использование `KabulTz` из примера выше:12691270```python1271>>> tz1 = KabulTz()12721273>>> # Datetime до изменения1274>>> dt1 = dt.datetime(1900, 11, 21, 16, 30, tzinfo=tz1)1275>>> print(dt1.utcoffset())12764:00:0012771278>>> # Datetime после изменения1279>>> dt2 = dt.datetime(2006, 6, 14, 13, 0, tzinfo=tz1)1280>>> print(dt2.utcoffset())12814:30:0012821283>>> # Преобразовать datetime в другой часовой пояс1284>>> dt3 = dt2.astimezone(dt.timezone.utc)1285>>> dt31286datetime.datetime(2006, 6, 14, 8, 30, tzinfo=datetime.timezone.utc)1287>>> dt21288datetime.datetime(2006, 6, 14, 13, 0, tzinfo=KabulTz())1289>>> dt2 == dt31290True1291```12921293## `time` объекты12941295Объект [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) представляет (локальное) время суток, не привязанное к определённому дню и может корректироваться с помощью объекта [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo).12961297#### `class datetime.time(hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)`12981299Все аргументы необязательны. *tzinfo* может быть `None` или экземпляром подкласса [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo). Остальные аргументы должны быть целыми числами в следующих диапазонах:13001301- `0 <= hour < 24`,1302- `0 <= minute < 60`,1303- `0 <= second < 60`,1304- `0 <= microsecond < 1000000`,1305- `fold in [0, 1]`.13061307Если указан аргумент вне этих диапазонов, возбуждается [`ValueError`](https://python-all.ru/3/library/exceptions.html#ValueError). Все по умолчанию равны 0, кроме *tzinfo*, который по умолчанию равен `None`.13081309Атрибуты класса:13101311#### `time.min`13121313Самое раннее представимое [`time`](https://python-all.ru/3/library/datetime.html#datetime.time), `time(0, 0, 0, 0)`.13141315#### `time.max`13161317Самое позднее представимое [`time`](https://python-all.ru/3/library/datetime.html#datetime.time), `time(23, 59, 59, 999999)`.13181319#### `time.resolution`13201321Наименьшая возможная разница между неравными объектами [`time`](https://python-all.ru/3/library/datetime.html#datetime.time), `timedelta(microseconds=1)`, хотя следует отметить, что арифметические операции над объектами `time` не поддерживаются.13221323Атрибуты экземпляра (только для чтения):13241325#### `time.hour`13261327В `range(24)`.13281329#### `time.minute`13301331В `range(60)`.13321333#### `time.second`13341335В `range(60)`.13361337#### `time.microsecond`13381339В `range(1000000)`.13401341#### `time.tzinfo`13421343Объект, переданный как аргумент tzinfo конструктору [`time`](https://python-all.ru/3/library/datetime.html#datetime.time), или `None`, если ничего не было передано.13441345#### `time.fold`13461347В `[0, 1]`. Используется для устранения неоднозначности поясного времени в повторяющемся интервале. (Повторяющийся интервал возникает, когда часы переводятся назад в конце перехода на летнее время или когда смещение UTC для текущего часового пояса уменьшается по политическим причинам.) Значения 0 и 1 представляют соответственно более ранний и более поздний из двух моментов с одинаковым представлением поясного времени.13481349Добавлено в версии 3.6.13501351Объекты [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) поддерживают сравнение на равенство и порядок, где `a` считается меньше `b`, если `a` предшествует `b` во времени.13521353Наивные и осведомлённые объекты `time` никогда не равны. Сравнение по порядку между наивными и осведомлёнными объектами `time` вызывает [`TypeError`](https://python-all.ru/3/library/exceptions.html#TypeError).13541355Если оба сравниваемых объекта осведомлённые и имеют одинаковый атрибут [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.time.tzinfo), атрибуты `tzinfo` и `fold` игнорируются, и сравниваются базовые времена. Если оба сравниваемых объекта осведомлённые и имеют разные атрибуты `tzinfo`, сравниваемые объекты сначала корректируются путём вычитания их смещений UTC (полученных из `self.utcoffset()`).13561357Изменено в версии 3.3: Сравнения на равенство между осведомлёнными и наивными экземплярами [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) не вызывают [`TypeError`](https://python-all.ru/3/library/exceptions.html#TypeError).13581359В булевом контексте объект [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) всегда считается истинным.13601361Изменено в версии 3.5: До Python 3.5 объект [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) считался ложным, если он представлял полночь по UTC. Это поведение считалось неочевидным и чреватым ошибками и было удалено в Python 3.5. См. [bpo-13936](https://python-all.ru/3/library/datetime.html) для получения дополнительной информации.13621363Другие конструкторы:13641365#### `classmethod time.fromisoformat(time_string)`13661367Возвращает объект [`time`](https://python-all.ru/3/library/datetime.html#datetime.time), соответствующий строке *time\_string* в любом допустимом формате ISO 8601, со следующими исключениями:136813691. Смещения часовых поясов могут содержать доли секунды.13702. Ведущий символ `T`, обычно обязательный в случаях, когда возможна неоднозначность между датой и временем, не требуется.13713. Доли секунды могут содержать любое количество цифр (всё, что больше 6, будет усечено).13724. Доли часов и минут не поддерживаются.13731374Примеры:13751376```pycon1377>>> import datetime as dt1378>>> dt.time.fromisoformat('04:23:01')1379datetime.time(4, 23, 1)1380>>> dt.time.fromisoformat('T04:23:01')1381datetime.time(4, 23, 1)1382>>> dt.time.fromisoformat('T042301')1383datetime.time(4, 23, 1)1384>>> dt.time.fromisoformat('04:23:01.000384')1385datetime.time(4, 23, 1, 384)1386>>> dt.time.fromisoformat('04:23:01,000384')1387datetime.time(4, 23, 1, 384)1388>>> dt.time.fromisoformat('04:23:01+04:00')1389datetime.time(4, 23, 1, tzinfo=datetime.timezone(datetime.timedelta(seconds=14400)))1390>>> dt.time.fromisoformat('04:23:01Z')1391datetime.time(4, 23, 1, tzinfo=datetime.timezone.utc)1392>>> dt.time.fromisoformat('04:23:01+00:00')1393datetime.time(4, 23, 1, tzinfo=datetime.timezone.utc)1394```13951396Добавлено в версии 3.7.13971398Изменено в версии 3.11: Ранее этот метод поддерживал только форматы, которые могли быть возвращены [`time.isoformat()`](https://python-all.ru/3/library/datetime.html#datetime.time.isoformat).13991400#### `classmethod time.strptime(date_string, format)`14011402Возвращает объект [`time`](https://python-all.ru/3/library/datetime.html#datetime.time), соответствующий *date\_string*, разобранный в соответствии с *format*.14031404Если *format* не содержит микросекунд или информации о часовом поясе, это эквивалентно:14051406```python1407time(*(time.strptime(date_string, format)[3:6]))1408```14091410Исключение [`ValueError`](https://python-all.ru/3/library/exceptions.html#ValueError) возникает, если *date\_string* и *format* не могут быть разобраны с помощью `time.strptime()` или если возвращается значение, не являющееся временным кортежем. См. также [поведение strftime() и strptime()](https://python-all.ru/3/library/datetime.html#strftime-strptime-behavior) и [`time.fromisoformat()`](https://python-all.ru/3/library/datetime.html#datetime.time.fromisoformat).14111412Добавлено в версии 3.14.14131414Методы экземпляра:14151416#### `time.replace(hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond, tzinfo=self.tzinfo, *, fold=0)`14171418Возвращает новый объект [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) с теми же значениями, но с обновлёнными указанными параметрами. Обратите внимание, что `tzinfo=None` может быть указан для создания наивного `time` из осведомлённого `time` без преобразования данных времени.14191420Объекты [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) также поддерживаются обобщённой функцией [`copy.replace()`](https://python-all.ru/3/library/copy.html#copy.replace).14211422Изменено в версии 3.6: Добавлен параметр *fold*.14231424#### `time.isoformat(timespec='auto')`14251426Возвращает строку, представляющую время в формате ISO 8601, одну из:14271428- `HH:MM:SS.ffffff`, если [`microsecond`](https://python-all.ru/3/library/datetime.html#datetime.time.microsecond) не равно 01429- `HH:MM:SS`, если [`microsecond`](https://python-all.ru/3/library/datetime.html#datetime.time.microsecond) равно 01430- `HH:MM:SS.ffffff+HH:MM[:SS[.ffffff]]`, если [`utcoffset()`](https://python-all.ru/3/library/datetime.html#datetime.time.utcoffset) не возвращает `None`1431- `HH:MM:SS+HH:MM[:SS[.ffffff]]`, если [`microsecond`](https://python-all.ru/3/library/datetime.html#datetime.time.microsecond) равно 0 и [`utcoffset()`](https://python-all.ru/3/library/datetime.html#datetime.time.utcoffset) не возвращает `None`14321433Необязательный аргумент *timespec* указывает количество дополнительных компонентов времени, которые нужно включить (по умолчанию `'auto'`). Он может быть одним из следующих:14341435- `'auto'`: То же, что и `'seconds'`, если [`microsecond`](https://python-all.ru/3/library/datetime.html#datetime.time.microsecond) равно 0, иначе то же, что и `'microseconds'`.1436- `'hours'`: Включает [`hour`](https://python-all.ru/3/library/datetime.html#datetime.time.hour) в двухзначном формате `HH`.1437- `'minutes'`: Включает [`hour`](https://python-all.ru/3/library/datetime.html#datetime.time.hour) и [`minute`](https://python-all.ru/3/library/datetime.html#datetime.time.minute) в формате `HH:MM`.1438- `'seconds'`: Включает [`hour`](https://python-all.ru/3/library/datetime.html#datetime.time.hour), [`minute`](https://python-all.ru/3/library/datetime.html#datetime.time.minute) и [`second`](https://python-all.ru/3/library/datetime.html#datetime.time.second) в формате `HH:MM:SS`.1439- `'milliseconds'`: Включает полное время, но усекает дробную часть секунд до миллисекунд. Формат `HH:MM:SS.sss`.1440- `'microseconds'`: Включает полное время в формате `HH:MM:SS.ffffff`.14411442> **Примечание**1443>1444> Исключённые компоненты времени усекаются, а не округляются.14451446[`ValueError`](https://python-all.ru/3/library/exceptions.html#ValueError) будет вызвано при недопустимом аргументе *timespec*.14471448Пример:14491450```python1451>>> import datetime as dt1452>>> dt.time(hour=12, minute=34, second=56, microsecond=123456).isoformat(timespec='minutes')1453'12:34'1454>>> my_time = dt.time(hour=12, minute=34, second=56, microsecond=0)1455>>> my_time.isoformat(timespec='microseconds')1456'12:34:56.000000'1457>>> my_time.isoformat(timespec='auto')1458'12:34:56'1459```14601461Изменено в версии 3.6: Добавлен параметр *timespec*.14621463#### `time.__str__()`14641465Для времени `t` `str(t)` эквивалентно `t.isoformat()`.14661467#### `time.strftime(format)`14681469Возвращает строку, представляющую время, управляемую явной строкой формата. См. также [поведение strftime() и strptime()](https://python-all.ru/3/library/datetime.html#strftime-strptime-behavior) и [`time.isoformat()`](https://python-all.ru/3/library/datetime.html#datetime.time.isoformat).14701471#### `time.__format__(format)`14721473То же, что и [`time.strftime()`](https://python-all.ru/3/library/datetime.html#datetime.time.strftime). Это позволяет указать строку формата для объекта [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) в [строковых литералах с форматированием](https://python-all.ru/3/reference/lexical_analysis.html#f-strings) и при использовании [`str.format()`](https://python-all.ru/3/library/stdtypes.html#str.format). См. также [поведение strftime() и strptime()](https://python-all.ru/3/library/datetime.html#strftime-strptime-behavior) и [`time.isoformat()`](https://python-all.ru/3/library/datetime.html#datetime.time.isoformat).14741475#### `time.utcoffset()`14761477Если [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.time.tzinfo) равно `None`, возвращает `None`, иначе возвращает `self.tzinfo.utcoffset(None)`, и возбуждает исключение, если последнее не возвращает `None` или объект [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta) с величиной менее одного дня.14781479Изменено в версии 3.7: Смещение UTC не ограничивается целым числом минут.14801481#### `time.dst()`14821483Если [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.time.tzinfo) равно `None`, возвращает `None`, иначе возвращает `self.tzinfo.dst(None)`, и возбуждает исключение, если последнее не возвращает `None` или объект [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta) с величиной менее одного дня.14841485Изменено в версии 3.7: Смещение DST не ограничивается целым числом минут.14861487#### `time.tzname()`14881489Если [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.time.tzinfo) равно `None`, возвращает `None`, иначе возвращает `self.tzinfo.tzname(None)`, или возбуждает исключение, если последнее не возвращает `None` или строковый объект.14901491### Примеры использования: `time`14921493Примеры работы с объектом [`time`](https://python-all.ru/3/library/datetime.html#datetime.time):14941495```python1496>>> import datetime as dt1497>>> class TZ1(dt.tzinfo):1498... def utcoffset(self, when):1499... return dt.timedelta(hours=1)1500... def dst(self, when):1501... return dt.timedelta(0)1502... def tzname(self, when):1503... return "+01:00"1504... def __repr__(self):1505... return f"{self.__class__.__name__}()"1506...1507>>> t = dt.time(12, 10, 30, tzinfo=TZ1())1508>>> t1509datetime.time(12, 10, 30, tzinfo=TZ1())1510>>> t.isoformat()1511'12:10:30+01:00'1512>>> t.dst()1513datetime.timedelta(0)1514>>> t.tzname()1515'+01:00'1516>>> t.strftime("%H:%M:%S %Z")1517'12:10:30 +01:00'1518>>> 'The {} is {:%H:%M}.'.format("time", t)1519'The time is 12:10.'1520```15211522## `tzinfo` объекты15231524#### `class datetime.tzinfo`15251526Это [абстрактный базовый класс](https://python-all.ru/3/glossary.html#term-abstract-base-class), то есть этот класс не следует инстанциировать напрямую. Определите подкласс `tzinfo` для хранения информации о конкретном часовом поясе.15271528Экземпляр (конкретного подкласса) `tzinfo` можно передать конструкторам объектов [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) и [`time`](https://python-all.ru/3/library/datetime.html#datetime.time). Последние рассматривают свои атрибуты как местное время, а объект `tzinfo` поддерживает методы, показывающие смещение местного времени от UTC, название часового пояса и смещение DST – все относительно переданного им объекта даты или времени.15291530Необходимо создать конкретный подкласс и (как минимум) реализовать стандартные методы `tzinfo`, необходимые для используемых методов [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime). Модуль `datetime` предоставляет [`timezone`](https://python-all.ru/3/library/datetime.html#datetime.timezone) – простой конкретный подкласс `tzinfo`, который может представлять часовые пояса с фиксированным смещением от UTC, такие как сам UTC или североамериканские EST и EDT.15311532Особое требование для сериализации с помощью pickle: подкласс `tzinfo` должен иметь метод [`__init__()`](https://python-all.ru/3/reference/datamodel.html#object.__init__), который можно вызвать без аргументов, иначе объект можно сериализовать, но возможно не удастся десериализовать обратно. Это техническое требование, которое может быть ослаблено в будущем.15331534Конкретному подклассу `tzinfo` может потребоваться реализовать следующие методы. Какие именно методы нужны, зависит от того, как используются осведомлённые (aware) объекты `datetime`. Если есть сомнения, просто реализуйте их все.15351536#### `tzinfo.utcoffset(dt)`15371538Возвращает смещение местного времени от UTC в виде объекта [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta), которое положительно к востоку от UTC. Если местное время к западу от UTC, оно должно быть отрицательным.15391540Это представляет *общее* смещение от UTC; например, если объект [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo) представляет как часовой пояс, так и корректировки DST, `utcoffset()` должен возвращать их сумму. Если смещение UTC неизвестно, верните `None`. В противном случае возвращаемое значение должно быть объектом [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta) строго между `-timedelta(hours=24)` и `timedelta(hours=24)` (величина смещения должна быть меньше одного дня). Большинство реализаций `utcoffset()` будут выглядеть как один из этих двух вариантов:15411542```python1543return CONSTANT # класс с фиксированным смещением1544return CONSTANT + self.dst(dt) # класс, учитывающий летнее время1545```15461547Если `utcoffset()` не возвращает `None`, то [`dst()`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo.dst) также не должен возвращать `None`.15481549Реализация по умолчанию `utcoffset()` возбуждает [`NotImplementedError`](https://python-all.ru/3/library/exceptions.html#NotImplementedError).15501551Изменено в версии 3.7: Смещение UTC не ограничивается целым числом минут.15521553#### `tzinfo.dst(dt)`15541555Возвращает поправку на летнее время (DST) в виде объекта [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta) или `None`, если информация о DST неизвестна.15561557Возвращает `timedelta(0)`, если DST не действует. Если DST действует, возвращает смещение в виде объекта [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta) (подробнее см. [`utcoffset()`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo.utcoffset)). Обратите внимание, что смещение DST, если применимо, уже добавлено к смещению UTC, возвращаемому `utcoffset()`, поэтому нет необходимости обращаться к `dst()`, если только вы не хотите получить информацию о DST отдельно. Например, [`datetime.timetuple()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.timetuple) вызывает метод `dst()` своего атрибута [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzinfo), чтобы определить, как должен быть установлен флаг [`tm_isdst`](https://python-all.ru/3/library/time.html#time.struct_time.tm_isdst), а [`tzinfo.fromutc()`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo.fromutc) вызывает `dst()` для учёта изменений DST при пересечении часовых поясов.15581559Экземпляр *tz* подкласса [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo), который моделирует как стандартное, так и летнее время, должен быть согласован в следующем смысле:15601561`tz.utcoffset(dt) - tz.dst(dt)`15621563должен возвращать один и тот же результат для каждого [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) *dt* с `dt.tzinfo == tz`. Для разумных подклассов `tzinfo` это выражение даёт «стандартное смещение» часового пояса, которое не должно зависеть от даты или времени, а только от географического положения. Реализация [`datetime.astimezone()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.astimezone) полагается на это, но не может обнаружить нарушения; ответственность за это лежит на программисте. Если подкласс `tzinfo` не может этого гарантировать, он может переопределить реализацию по умолчанию [`tzinfo.fromutc()`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo.fromutc), чтобы она корректно работала с `astimezone()` в любом случае.15641565Большинство реализаций `dst()`, вероятно, будут выглядеть как один из этих двух вариантов:15661567```python1568import datetime as dt15691570def dst(self, when):1571 # класс с фиксированным смещением: не учитывает летнее время1572 return dt.timedelta(0)1573```15741575или:15761577```python1578import datetime as dt15791580def dst(self, when):1581 # Код для установки dston и dstoff в значения летнего времени часового пояса1582 # время перехода на основе входного when.year, выраженное1583 # в стандартном местном времени.15841585 if dston <= when.replace(tzinfo=None) < dstoff:1586 return dt.timedelta(hours=1)1587 else:1588 return dt.timedelta(0)1589```15901591Реализация по умолчанию `dst()` вызывает исключение [`NotImplementedError`](https://python-all.ru/3/library/exceptions.html#NotImplementedError).15921593Изменено в версии 3.7: Смещение DST не ограничивается целым числом минут.15941595#### `tzinfo.tzname(dt)`15961597Возвращает название часового пояса, соответствующее объекту [`datetime`](https://python-all.ru/3/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/library/datetime.html#datetime.tzinfo) могут возвращать разные названия в зависимости от конкретного значения переданного *dt*, особенно если класс `tzinfo` учитывает летнее время.15981599Реализация по умолчанию `tzname()` вызывает исключение [`NotImplementedError`](https://python-all.ru/3/library/exceptions.html#NotImplementedError).16001601Эти методы вызываются объектом [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) или [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) в ответ на их одноимённые методы. Объект `datetime` передаёт себя в качестве аргумента, а объект `time` передаёт `None`. Поэтому методы подкласса [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo) должны быть готовы принять аргумент *dt* типа `None` или класса `datetime`.16021603Когда передаётся `None`, разработчик класса должен решить, какой ответ будет наилучшим. Например, возврат `None` уместен, если класс хочет показать, что объекты времени не участвуют в протоколах [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo). Возможно, более полезным будет, чтобы `utcoffset(None)` возвращал стандартное смещение UTC, так как нет другого соглашения для его определения.16041605Когда объект [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) передаётся в ответ на метод `datetime`, `dt.tzinfo` является тем же объектом, что и *self*. Методы [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo) могут на это полагаться, если только пользовательский код не вызывает методы `tzinfo` напрямую. Смысл в том, что методы `tzinfo` интерпретируют *dt* как местное время и не должны беспокоиться об объектах в других часовых поясах.16061607Существует ещё один метод [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo), который подкласс может переопределить:16081609#### `tzinfo.fromutc(dt)`16101611Этот метод вызывается из реализации по умолчанию [`datetime.astimezone()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.astimezone). При таком вызове `dt.tzinfo` является *self*, а данные даты и времени *dt* рассматриваются как время UTC. Цель `fromutc()` – скорректировать данные даты и времени, вернув эквивалентный datetime в местном времени *self*.16121613Большинство подклассов [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo) должны без проблем наследовать реализацию по умолчанию `fromutc()`. Она достаточно сильна, чтобы обрабатывать часовые пояса с фиксированным смещением, а также пояса, учитывающие стандартное и летнее время, причём последние – даже если время перехода на летнее время различается в разные годы. Пример часового пояса, который реализация по умолчанию `fromutc()` может обрабатывать неправильно в некоторых случаях, – это пояс, где стандартное смещение (от UTC) зависит от конкретной переданной даты и времени, что может происходить по политическим причинам. Реализации по умолчанию [`astimezone()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.astimezone) и `fromutc()` могут не дать желаемого результата, если результат приходится на часы, пересекающие момент изменения стандартного смещения.16141615Опуская код для обработки ошибок, реализация по умолчанию `fromutc()` работает следующим образом:16161617```python1618import datetime as dt16191620def fromutc(self, when):1621 # вызывает ValueError, если when.tzinfo не является self1622 dtoff = when.utcoffset()1623 dtdst = when.dst()1624 # вызывает ValueError, если dtoff или dtdst равны None1625 delta = dtoff - dtdst # это стандартное смещение self1626 if delta:1627 when += delta # преобразовать в стандартное местное время1628 dtdst = when.dst()1629 # вызывает ValueError, если dtdst равен None1630 if dtdst:1631 return when + dtdst1632 else:1633 return when1634```16351636В следующем файле [`tzinfo_examples.py`](https://python-all.ru/3/_downloads/6dc1f3f4f0e6ca13cb42ddf4d6cbc8af/tzinfo_examples.py) приведены некоторые примеры классов [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo):16371638```python1639import datetime as dt16401641# Класс, отражающий представление платформы о местном времени.1642# (Может приводить к неверным значениям для исторических моментов в1643# часовых поясах, где UTC-смещение и/или правила летнего времени1644# менялись в прошлом.)1645import time16461647ZERO = dt.timedelta(0)1648HOUR = dt.timedelta(hours=1)1649SECOND = dt.timedelta(seconds=1)16501651STDOFFSET = dt.timedelta(seconds=-time.timezone)1652if time.daylight:1653 DSTOFFSET = dt.timedelta(seconds=-time.altzone)1654else:1655 DSTOFFSET = STDOFFSET16561657DSTDIFF = DSTOFFSET - STDOFFSET16581659class LocalTimezone(dt.tzinfo):16601661 def fromutc(self, when):1662 assert when.tzinfo is self1663 stamp = (when - dt.datetime(1970, 1, 1, tzinfo=self)) // SECOND1664 args = time.localtime(stamp)[:6]1665 dst_diff = DSTDIFF // SECOND1666 # Обнаружение fold1667 fold = (args == time.localtime(stamp - dst_diff))1668 return dt.datetime(*args, microsecond=when.microsecond,1669 tzinfo=self, fold=fold)16701671 def utcoffset(self, when):1672 if self._isdst(when):1673 return DSTOFFSET1674 else:1675 return STDOFFSET16761677 def dst(self, when):1678 if self._isdst(when):1679 return DSTDIFF1680 else:1681 return ZERO16821683 def tzname(self, when):1684 return time.tzname[self._isdst(when)]16851686 def _isdst(self, when):1687 tt = (when.year, when.month, when.day,1688 when.hour, when.minute, when.second,1689 when.weekday(), 0, 0)1690 stamp = time.mktime(tt)1691 tt = time.localtime(stamp)1692 return tt.tm_isdst > 016931694Local = LocalTimezone()16951696# Полная реализация текущих правил летнего времени для основных часовых поясов США.16971698def first_sunday_on_or_after(when):1699 days_to_go = 6 - when.weekday()1700 if days_to_go:1701 when += dt.timedelta(days_to_go)1702 return when17031704# Правила летнего времени в США1705#1706# Это упрощённый набор правил для США (т.е. неверный для некоторых случаев)1707# времени начала и окончания летнего времени. Полный и актуальный набор правил летнего времени1708# и определений часовых поясов смотрите в базе данных Olson (или попробуйте pytz):1709# http://www.twinsun.com/tz/tz-link.htm1710# https://sourceforge.net/projects/pytz/ (возможно, не актуально)1711#1712# В США с 2007 года летнее время начинается в 2 часа ночи (стандартное время) во второе1713# воскресенье марта, то есть первое воскресенье 8 марта или после него.1714DSTSTART_2007 = dt.datetime(1, 3, 8, 2)1715# и заканчивается в 2 часа ночи (летнее время) в первое воскресенье ноября.1716DSTEND_2007 = dt.datetime(1, 11, 1, 2)1717# С 1987 по 2006 год летнее время начиналось в 2 часа ночи (стандартное время) в первое1718# воскресенье апреля и заканчивалось в 2 часа ночи (летнее время) в последнее1719# воскресенье октября, то есть первое воскресенье 25 октября или после него.1720DSTSTART_1987_2006 = dt.datetime(1, 4, 1, 2)1721DSTEND_1987_2006 = dt.datetime(1, 10, 25, 2)1722# С 1967 по 1986 год летнее время начиналось в 2 часа ночи (стандартное время) в последнее1723# воскресенье апреля (то есть 24 апреля или после него) и заканчивалось в 2 часа ночи (летнее время)1724# в последнее воскресенье октября, которое является первым воскресеньем1725# 25 октября или позднее.1726DSTSTART_1967_1986 = dt.datetime(1, 4, 24, 2)1727DSTEND_1967_1986 = DSTEND_1987_200617281729def us_dst_range(year):1730 # Найти время начала и окончания перехода на летнее время в США. Для лет до 1967 года вернуть1731 # start = end, если летнее время не применяется.1732 if 2006 < year:1733 dststart, dstend = DSTSTART_2007, DSTEND_20071734 elif 1986 < year < 2007:1735 dststart, dstend = DSTSTART_1987_2006, DSTEND_1987_20061736 elif 1966 < year < 1987:1737 dststart, dstend = DSTSTART_1967_1986, DSTEND_1967_19861738 else:1739 return (dt.datetime(year, 1, 1), ) * 217401741 start = first_sunday_on_or_after(dststart.replace(year=year))1742 end = first_sunday_on_or_after(dstend.replace(year=year))1743 return start, end17441745class USTimeZone(dt.tzinfo):17461747 def __init__(self, hours, reprname, stdname, dstname):1748 self.stdoffset = dt.timedelta(hours=hours)1749 self.reprname = reprname1750 self.stdname = stdname1751 self.dstname = dstname17521753 def __repr__(self):1754 return self.reprname17551756 def tzname(self, when):1757 if self.dst(when):1758 return self.dstname1759 else:1760 return self.stdname17611762 def utcoffset(self, when):1763 return self.stdoffset + self.dst(when)17641765 def dst(self, when):1766 if when is None or when.tzinfo is None:1767 # В одном или обоих случаях здесь может быть уместно исключение.1768 # Это зависит от того, как вы хотите их обрабатывать. Реализация по умолчанию1769 # fromutc() (вызываемая реализацией astimezone() по умолчанию)1770 # передаёт объект datetime, у которого when.tzinfo равен self.1771 return ZERO1772 assert when.tzinfo is self1773 start, end = us_dst_range(when.year)1774 # Нельзя сравнивать наивные и осведомлённые объекты, поэтому сначала удалите часовой пояс из1775 # when.1776 when = when.replace(tzinfo=None)1777 if start + HOUR <= when < end - HOUR:1778 # Действует летнее время.1779 return HOUR1780 if end - HOUR <= when < end:1781 # Fold (неоднозначный час): используйте when.fold для разрешения неоднозначности.1782 return ZERO if when.fold else HOUR1783 if start <= when < start + HOUR:1784 # Gap (несуществующий час): примените обратное правило fold.1785 return HOUR if when.fold else ZERO1786 # Летнее время не действует.1787 return ZERO17881789 def fromutc(self, when):1790 assert when.tzinfo is self1791 start, end = us_dst_range(when.year)1792 start = start.replace(tzinfo=self)1793 end = end.replace(tzinfo=self)1794 std_time = when + self.stdoffset1795 dst_time = std_time + HOUR1796 if end <= dst_time < end + HOUR:1797 # Повторяющийся час1798 return std_time.replace(fold=1)1799 if std_time < start or dst_time >= end:1800 # Стандартное время1801 return std_time1802 if start <= std_time < end - HOUR:1803 # Летнее время1804 return dst_time18051806Eastern = USTimeZone(-5, "Eastern", "EST", "EDT")1807Central = USTimeZone(-6, "Central", "CST", "CDT")1808Mountain = USTimeZone(-7, "Mountain", "MST", "MDT")1809Pacific = USTimeZone(-8, "Pacific", "PST", "PDT")1810```18111812Обратите внимание, что в подклассе [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo), учитывающем как стандартное, так и летнее время, дважды в год в точках перехода на летнее время возникают неизбежные тонкости. Для конкретики рассмотрим восточное время США (UTC -0500), где EDT начинается через минуту после 1:59 (EST) во второе воскресенье марта и заканчивается через минуту после 1:59 (EDT) в первое воскресенье ноября:18131814```python1815 UTC 3:MM 4:MM 5:MM 6:MM 7:MM 8:MM1816 EST 22:MM 23:MM 0:MM 1:MM 2:MM 3:MM1817 EDT 23:MM 0:MM 1:MM 2:MM 3:MM 4:MM18181819start 22:MM 23:MM 0:MM 1:MM 3:MM 4:MM18201821 end 23:MM 0:MM 1:MM 1:MM 2:MM 3:MM1822```18231824Когда начинается летнее время (строка «start»), местные настенные часы перескакивают с 1:59 на 3:00. Местное время вида 2:MM в этот день не имеет смысла, поэтому `astimezone(Eastern)` не вернёт результат с `hour == 2` в день начала DST. Например, при переходе на летнее время весной 2016 года мы получаем:18251826```python1827>>> import datetime as dt1828>>> from tzinfo_examples import HOUR, Eastern1829>>> u0 = dt.datetime(2016, 3, 13, 5, tzinfo=dt.timezone.utc)1830>>> for i in range(4):1831... u = u0 + i*HOUR1832... t = u.astimezone(Eastern)1833... print(u.time(), 'UTC =', t.time(), t.tzname())1834...183505:00:00 UTC = 00:00:00 EST183606:00:00 UTC = 01:00:00 EST183707:00:00 UTC = 03:00:00 EDT183808:00:00 UTC = 04:00:00 EDT1839```18401841Когда заканчивается летнее время (строка «end»), возникает потенциально более серьёзная проблема: есть час, который невозможно однозначно выразить в местном настенном времени – последний час летнего времени. В восточном поясе это время вида 5:MM UTC в день окончания летнего времени. Местные настенные часы перескакивают с 1:59 (летнее время) обратно на 1:00 (стандартное время). Местные времена вида 1:MM становятся неоднозначными. [`astimezone()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.astimezone) имитирует поведение местных часов, отображая два соседних часа UTC в один и тот же местный час. В примере с восточным поясом времена UTC вида 5:MM и 6:MM оба отображаются в 1:MM при преобразовании в восточное время, но у более ранних времен атрибут [`fold`](https://python-all.ru/3/library/datetime.html#datetime.datetime.fold) установлен в 0, а у более поздних – в 1. Например, при переходе на зимнее время осенью 2016 года мы получаем:18421843```python1844>>> import datetime as dt1845>>> from tzinfo_examples import HOUR, Eastern1846>>> u0 = dt.datetime(2016, 11, 6, 4, tzinfo=dt.timezone.utc)1847>>> for i in range(4):1848... u = u0 + i*HOUR1849... t = u.astimezone(Eastern)1850... print(u.time(), 'UTC =', t.time(), t.tzname(), t.fold)1851...185204:00:00 UTC = 00:00:00 EDT 0185305:00:00 UTC = 01:00:00 EDT 0185406:00:00 UTC = 01:00:00 EST 1185507:00:00 UTC = 02:00:00 EST 01856```18571858Обратите внимание, что экземпляры [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime), отличающиеся только значением атрибута [`fold`](https://python-all.ru/3/library/datetime.html#datetime.datetime.fold), считаются равными при сравнении.18591860Приложения, которые не могут мириться с неоднозначностью местного времени, должны явно проверять значение атрибута [`fold`](https://python-all.ru/3/library/datetime.html#datetime.datetime.fold) или избегать использования гибридных подклассов [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo); неоднозначности отсутствуют при использовании [`timezone`](https://python-all.ru/3/library/datetime.html#datetime.timezone) или любого другого подкласса `tzinfo` с фиксированным смещением (например, класс, представляющий только EST (фиксированное смещение -5 часов) или только EDT (фиксированное смещение -4 часа)).18611862> **См. также**1863>1864> > **[`zoneinfo`](https://python-all.ru/3/library/zoneinfo.html#module-zoneinfo)**1865> >1866> > Модуль `datetime` содержит базовый класс [`timezone`](https://python-all.ru/3/library/datetime.html#datetime.timezone) (для обработки произвольных фиксированных смещений от UTC) и его атрибут [`timezone.utc`](https://python-all.ru/3/library/datetime.html#datetime.timezone.utc) (экземпляр UTC `timezone`).1867> >1868> > `zoneinfo` предоставляет Python базу данных *IANA time zone database* (также известную как база данных Olson), и её использование рекомендуется.1869>1870> **[IANA time zone database](https://python-all.ru/3/library/datetime.html)**1871>1872> База данных часовых поясов (часто называемая tz, tzdata или zoneinfo) содержит код и данные, представляющие историю местного времени для множества характерных мест по всему миру. Она периодически обновляется, чтобы отражать изменения, вносимые политическими органами в границы часовых поясов, смещения UTC и правила перехода на летнее время.18731874## `timezone` объекты18751876Класс [`timezone`](https://python-all.ru/3/library/datetime.html#datetime.timezone) является подклассом [`tzinfo`](https://python-all.ru/3/library/datetime.html#datetime.tzinfo), каждый экземпляр которого представляет часовой пояс, определяемый фиксированным смещением от UTC.18771878Объекты этого класса нельзя использовать для представления информации о часовом поясе в местах, где в разные дни года используются разные смещения или где в гражданское время вносились исторические изменения.18791880#### `class datetime.timezone(offset, name=None)`18811882Аргумент *offset* должен быть задан как объект [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta), представляющий разницу между местным временем и UTC. Он должен находиться строго между `-timedelta(hours=24)` и `timedelta(hours=24)`, в противном случае возникает исключение [`ValueError`](https://python-all.ru/3/library/exceptions.html#ValueError).18831884Аргумент *name* необязателен. Если он указан, это должна быть строка, которая будет использоваться в качестве значения, возвращаемого методом [`datetime.tzname()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzname).18851886Добавлено в версии 3.2.18871888Изменено в версии 3.7: Смещение UTC не ограничивается целым числом минут.18891890#### `timezone.utcoffset(dt)`18911892Возвращает фиксированное значение, указанное при создании экземпляра [`timezone`](https://python-all.ru/3/library/datetime.html#datetime.timezone).18931894Аргумент *dt* игнорируется. Возвращаемое значение – экземпляр [`timedelta`](https://python-all.ru/3/library/datetime.html#datetime.timedelta), равный разнице между местным временем и UTC.18951896Изменено в версии 3.7: Смещение UTC теперь не ограничивается целым числом минут.18971898#### `timezone.tzname(dt)`18991900Возвращает фиксированное значение, указанное при создании экземпляра [`timezone`](https://python-all.ru/3/library/datetime.html#datetime.timezone).19011902Если *name* не указан в конструкторе, имя, возвращаемое `tzname(dt)`, генерируется из значения `offset` следующим образом. Если *offset* равно `timedelta(0)`, то имя – «UTC», иначе это строка в формате `UTC±HH:MM`, где ± – это знак `offset`, HH и MM – две цифры `offset.hours` и `offset.minutes` соответственно.19031904Изменено в версии 3.6: Имя, генерируемое из `offset=timedelta(0)`, теперь является обычным `'UTC'`, а не `'UTC+00:00'`.19051906#### `timezone.dst(dt)`19071908Всегда возвращает `None`.19091910#### `timezone.fromutc(dt)`19111912Возвращает `dt + offset`. Аргумент *dt* должен быть осведомлённым экземпляром [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime), с `tzinfo`, установленным в `self`.19131914Атрибуты класса:19151916#### `timezone.utc`19171918Часовой пояс UTC, `timezone(timedelta(0))`.19191920## Поведение `strftime()` и `strptime()`19211922Объекты [`date`](https://python-all.ru/3/library/datetime.html#datetime.date), [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime) и [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) поддерживают метод `strftime(format)`, который создаёт строку, представляющую время с использованием явной строки формата.19231924И наоборот, методы классов [`date.strptime()`](https://python-all.ru/3/library/datetime.html#datetime.date.strptime), [`datetime.strptime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strptime) и [`time.strptime()`](https://python-all.ru/3/library/time.html#time.strptime) создают объект из строки, представляющей время, и соответствующей строки формата.19251926Приведённая ниже таблица даёт высокоуровневое сравнение [`strftime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strftime) и [`strptime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strptime):19271928| | `strftime` | `strptime` |1929| --- | --- | --- |1930| Использование | Преобразовать объект в строку по заданному формату | Разобрать строку в объект по соответствующему формату |1931| Тип метода | Метод экземпляра | Метод класса |1932| Сигнатура | `strftime(format)` | `strptime(date_string, format)` |19331934>19351936### Коды формата `strftime()` и `strptime()`19371938Эти методы принимают коды формата, которые можно использовать для разбора и форматирования дат:19391940```python1941>>> import datetime as dt1942>>> dt.datetime.strptime('31/01/22 23:59:59.999999',1943... '%d/%m/%y %H:%M:%S.%f')1944datetime.datetime(2022, 1, 31, 23, 59, 59, 999999)1945>>> _.strftime('%a %d %b %Y, %I:%M%p')1946'Mon 31 Jan 2022, 11:59PM'1947```19481949Ниже приведён список всех кодов формата, требуемых стандартом C 1989 года, и они работают на всех платформах со стандартной реализацией C.19501951| Директива | Значение | Пример | Примечания |1952| --- | --- | --- | --- |1953| `%a` | День недели как сокращённое название в локали. | Sun, Mon, …, Sat (en\_US); So, Mo, …, Sa (de\_DE) | (1) |1954| `%A` | Название дня недели в полной форме, зависящее от локали. | Sunday, Monday, …, Saturday (en\_US); Sonntag, Montag, …, Samstag (de\_DE) | (1) |1955| `%w` | День недели в виде десятичного числа, где 0 – воскресенье, а 6 – суббота. | 0, 1, …, 6 | |1956| `%d` | День месяца в виде десятичного числа, дополненного слева нулями. | 01, 02, …, 31 | (9) |1957| `%b` | Название месяца в сокращённой форме, зависящей от локали. | Jan, Feb, …, Dec (en\_US); Jan, Feb, …, Dez (de\_DE) | (1) |1958| `%B` | Название месяца в полной форме, зависящей от локали. | January, February, …, December (en\_US); Januar, Februar, …, Dezember (de\_DE) | (1) |1959| `%m` | Месяц в виде десятичного числа, дополненного слева нулями. | 01, 02, …, 12 | (9) |1960| `%y` | Год без столетия в виде десятичного числа, дополненного слева нулями. | 00, 01, …, 99 | (9) |1961| `%Y` | Год со столетием в виде десятичного числа. | 0001, 0002, …, 2013, 2014, …, 9998, 9999 | (2) |1962| `%H` | Часы (в 24-часовом формате) в виде десятичного числа, дополненного слева нулями. | 00, 01, …, 23 | (9) |1963| `%I` | Часы (в 12-часовом формате) в виде десятичного числа, дополненного слева нулями. | 01, 02, …, 12 | (9) |1964| `%p` | Эквивалент AM или PM, зависящий от локали. | AM, PM (en\_US); am, pm (de\_DE) | (1), (3) |1965| `%M` | Минуты в виде десятичного числа, дополненного слева нулями. | 00, 01, …, 59 | (9) |1966| `%S` | Секунды в виде десятичного числа, дополненного слева нулями. | 00, 01, …, 59 | (4), (9) |1967| `%f` | Микросекунды в виде десятичного числа, дополненного слева нулями до 6 цифр. | 000000, 000001, …, 999999 | (5) |1968| `%z` | Смещение UTC в формате `±HHMM[SS[.ffffff]]` (пустая строка, если объект наивный). | (empty), +0000, -0400, +1030, +063415, -030712.345216 | (6) |1969| `%Z` | Название часового пояса (пустая строка, если объект наивный). | (empty), UTC, GMT | (6) |1970| `%j` | День года в виде десятичного числа, дополненного слева нулями. | 001, 002, …, 366 | (9) |1971| `%U` | Номер недели в году (воскресенье – первый день недели) в виде десятичного числа, дополненного слева нулями. Все дни в новом году до первого воскресенья считаются неделей 0. | 00, 01, …, 53 | (7), (9) |1972| `%W` | Номер недели в году (понедельник – первый день недели) в виде десятичного числа, дополненного слева нулями. Все дни в новом году до первого понедельника считаются неделей 0. | 00, 01, …, 53 | (7), (9) |1973| `%c` | Представление даты и времени, подходящее для локали. | Tue Aug 16 21:30:00 1988 (en\_US); Di 16 Aug 21:30:00 1988 (de\_DE) | (1) |1974| `%x` | Представление даты, соответствующее локали. | 08/16/88 (None); 08/16/1988 (en\_US); 16.08.1988 (de\_DE) | (1) |1975| `%X` | Представление времени, соответствующее локали. | 21:30:00 (en\_US); 21:30:00 (de\_DE) | (1) |1976| `%%` | Литеральный символ `'%'`. | % | |19771978Для удобства включено несколько дополнительных директив, не требуемых стандартом C89. Все эти параметры соответствуют значениям дат ISO 8601.19791980| Директива | Значение | Пример | Примечания |1981| --- | --- | --- | --- |1982| `%G` | Год по ISO 8601 с веком, представляющий год, который содержит большую часть недели по ISO 8601 (`%V`). | 0001, 0002, …, 2013, 2014, …, 9998, 9999 | (8) |1983| `%u` | День недели по ISO 8601 в виде десятичного числа, где 1 – понедельник. | 1, 2, …, 7 | |1984| `%V` | Неделя по ISO 8601 в виде десятичного числа, где понедельник считается первым днём недели. Неделя 01 – это неделя, содержащая 4 января. | 01, 02, …, 53 | (8), (9) |1985| `%:z` | Смещение UTC в формате `±HH:MM[:SS[.ffffff]]` (пустая строка, если объект наивный). | (пусто), +00:00, -04:00, +10:30, +06:34:15, -03:07:12.345216 | (6) |19861987Они могут быть доступны не на всех платформах при использовании с методом [`strftime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strftime). Директивы года по ISO 8601 и недели по ISO 8601 не взаимозаменяемы с указанными выше директивами года и номера недели. Вызов [`strptime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strptime) с неполными или неоднозначными директивами ISO 8601 приведёт к возникновению [`ValueError`](https://python-all.ru/3/library/exceptions.html#ValueError).19881989Полный набор поддерживаемых кодов формата зависит от платформы, поскольку Python вызывает функцию `strftime()` из библиотеки C платформы, а различия между платформами распространены. Чтобы увидеть полный набор кодов формата, поддерживаемых на вашей платформе, обратитесь к документации *[strftime(3)](https://python-all.ru/3/library/datetime.html)*. Также существуют различия между платформами в обработке неподдерживаемых спецификаторов формата.19901991Добавлено в версии 3.6: `%G`, `%u` и `%V` были добавлены.19921993Добавлено в версии 3.12: `%:z` был добавлен.19941995### Техническая подробность19961997В целом, `d.strftime(fmt)` действует как [`time`](https://python-all.ru/3/library/time.html#module-time) из модуля `time.strftime(fmt, d.timetuple())`, хотя не все объекты поддерживают метод [`timetuple()`](https://python-all.ru/3/library/datetime.html#datetime.date.timetuple).19981999Для методов класса [`datetime.strptime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strptime) и [`date.strptime()`](https://python-all.ru/3/library/datetime.html#datetime.date.strptime) значение по умолчанию равно `1900-01-01T00:00:00.000`: любые компоненты, не указанные в строке формата, будут взяты из значения по умолчанию.20002001> **Примечание**2002>2003> Строки формата без разделителей могут быть неоднозначными для разбора. Например, при `%Y%m%d` строка `2026111` может быть разобрана как `2026-11-01` или как `2026-01-11`. Используйте разделители, чтобы гарантировать, что входные данные разбираются так, как задумано.20042005> **Примечание**2006>2007> При использовании для разбора частичных дат без указания года [`datetime.strptime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strptime) и [`date.strptime()`](https://python-all.ru/3/library/datetime.html#datetime.date.strptime) вызовут ошибку при обнаружении 29 февраля, поскольку год по умолчанию 1900 *не является* високосным. Всегда добавляйте високосный год по умолчанию к строкам частичных дат перед разбором.20082009```pycon2010>>> import datetime as dt2011>>> value = "2/29"2012>>> dt.datetime.strptime(value, "%m/%d")2013Traceback (most recent call last):2014...2015ValueError: day 29 must be in range 1..28 for month 2 in year 19002016>>> dt.datetime.strptime(f"1904 {value}", "%Y %m/%d")2017datetime.datetime(1904, 2, 29, 0, 0)2018```20192020Использование `datetime.strptime(date_string, format)` эквивалентно:20212022```python2023datetime(*(time.strptime(date_string, format)[0:6]))2024```20252026за исключением случаев, когда формат включает компоненты долей секунды или информацию о часовом поясе, которые поддерживаются в `datetime.strptime`, но отбрасываются `time.strptime`.20272028Для объектов [`time`](https://python-all.ru/3/library/datetime.html#datetime.time) не следует использовать коды формата для года, месяца и дня, поскольку у объектов `time` таких значений нет. Если они всё же используются, для года подставляется 1900, а для месяца и дня – 1.20292030Для объектов [`date`](https://python-all.ru/3/library/datetime.html#datetime.date) не следует использовать коды формата для часов, минут, секунд и микросекунд, поскольку у объектов `date` таких значений нет. Если они всё же используются, для них подставляется 0.20312032По той же причине обработка строк формата, содержащих кодовые точки Unicode, которые не могут быть представлены в кодировке текущей локали, также зависит от платформы. На некоторых платформах такие кодовые точки сохраняются в выходных данных без изменений, в то время как на других `strftime` может вызвать [`UnicodeError`](https://python-all.ru/3/library/exceptions.html#UnicodeError) или вернуть пустую строку.20332034Примечания:203520361. Поскольку формат зависит от текущей локали, следует проявлять осторожность при построении предположений о выходном значении. Порядок полей различается (например, «месяц/день/год» против «день/месяц/год»), и вывод может содержать не-ASCII символы.20372. Метод [`strptime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strptime) может разбирать годы в полном диапазоне \[1, 9999\], но годы \< 1000 должны быть дополнены нулями до 4-значной ширины.20382039 Изменено в версии 3.2: В предыдущих версиях метод [`strftime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strftime) был ограничен gодами \>= 1900.20402041 Изменено в версии 3.3: В версии 3.2 метод [`strftime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strftime) был ограничен gодами \>= 1000.20423. При использовании с методом [`strptime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strptime) директива `%p` влияет только на поле вывода часа, если директива `%I` используется для разбора часа.20434. В отличие от модуля [`time`](https://python-all.ru/3/library/time.html#module-time), модуль `datetime` не поддерживает високосные секунды.20445. При использовании с методом [`strptime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strptime) директива `%f` принимает от одной до шести цифр и дополняет нулями справа. `%f` является расширением набора символов форматирования в стандарте C (но реализован отдельно в объектах datetime, поэтому всегда доступен).20456. Для наивного объекта коды форматирования `%z`, `%:z` и `%Z` заменяются пустыми строками.20462047 Для осведомлённого объекта:20482049 **`%z`**20502051 [`utcoffset()`](https://python-all.ru/3/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'`.20522053 Изменено в версии 3.7: Смещение UTC теперь не ограничено целым числом минут.20542055 Изменено в версии 3.7: Когда директива `%z` передаётся методу [`strptime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strptime), смещения UTC могут содержать двоеточие в качестве разделителя между часами, минутами и секундами. Например, `'+01:00:00'` будет разобрано как смещение в один час. Кроме того, указание `'Z'` эквивалентно `'+00:00'`.20562057 **`%:z`**20582059 Ведёт себя точно так же, как `%z`, но с добавлением двоеточия в качестве разделителя между часами, минутами и секундами.20602061 **`%Z`**20622063 В [`strftime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strftime) `%Z` заменяется пустой строкой, если [`tzname()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.tzname) возвращает `None`; в противном случае `%Z` заменяется возвращённым значением, которое должно быть строкой.20642065 [`strptime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strptime) принимает только определённые значения для `%Z`:20662067 1. любое значение из `time.tzname` для локали вашей системы2068 2. жёстко заданные значения `UTC` и `GMT`20692070 Так, человек, живущий в Японии, может иметь `JST`, `UTC` и `GMT` в качестве допустимых значений, но, вероятно, не `EST`. Для недопустимых значений будет возбуждено `ValueError`.20712072 Изменено в версии 3.2: Когда директива `%z` передаётся методу [`strptime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strptime), будет создан осведомлённый объект [`datetime`](https://python-all.ru/3/library/datetime.html#datetime.datetime). Атрибут `tzinfo` результата будет установлен в экземпляр [`timezone`](https://python-all.ru/3/library/datetime.html#datetime.timezone).20737. При использовании с методом [`strptime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strptime) `%U` и `%W` используются только в вычислениях, когда указаны день недели и календарный год (`%Y`).20748. Аналогично `%U` и `%W`, `%V` используется только в вычислениях, когда день недели и год по ISO (`%G`) указаны в строке форматирования [`strptime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strptime). Также обратите внимание, что `%G` и `%Y` не являются взаимозаменяемыми.20759. При использовании с методом [`strptime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strptime) ведущий ноль является необязательным для форматов `%d`, `%m`, `%H`, `%I`, `%M`, `%S`, `%j`, `%U`, `%W` и `%V`. Формат `%y` требует ведущего нуля.207610. При разборе месяца и дня с помощью [`strptime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strptime) всегда включайте год в формат. Если разбираемое значение не содержит года, добавьте явный фиктивный високосный год. В противном случае ваш код возбудит исключение при обнаружении високосного дня, так как год по умолчанию, используемый парсером (1900), не является високосным. Пользователи сталкиваются с этой ошибкой каждый високосный год.20772078 ```pycon2079 >>> month_day = "02/29"2080 >>> dt.datetime.strptime(f"{month_day};1984", "%m/%d;%Y") # Нет ошибки високосного года.2081 datetime.datetime(1984, 2, 29, 0, 0)2082 ```20832084 Устарело с версии 3.13, будет удалено в версии 3.15: Вызовы [`strptime()`](https://python-all.ru/3/library/datetime.html#datetime.datetime.strptime) с использованием строки форматирования, содержащей день месяца без года, теперь вызывают [`DeprecationWarning`](https://python-all.ru/3/library/exceptions.html#DeprecationWarning). В версии 3.15 или позднее это может быть изменено на ошибку или год по умолчанию может быть изменён на високосный. См. [gh-70647](https://python-all.ru/3/library/datetime.html).20852086Сноски20872088\[[1](https://python-all.ru/3/library/datetime.html#id1)\]20892090Если, конечно, пренебречь эффектами относительности.20912092\[[2](https://python-all.ru/3/library/datetime.html#id2)\]20932094Это соответствует определению пролептического григорианского календаря в книге Дершовица и Рейнгольда *Calendrical Calculations*, где он является базовым календарём для всех вычислений. Смотрите книгу для алгоритмов преобразования между пролептическими григорианскими порядковыми номерами и многими другими календарными системами.20952096\[[3](https://python-all.ru/3/library/datetime.html#id3)\]20972098Смотрите [руководство по математике календаря ISO 8601](https://python-all.ru/3/library/datetime.html) Р. Х. ван Гента для хорошего объяснения.2099