isoformat и fromisoformat: ISO-даты

После шпаргалки кодов кажется, что любую дату в строку превращают шаблонами. Для хранения и передачи данных есть путь короче — международный стандарт ISO 8601 и метод isoformat, которому не нужен ни один код с процентом. Шпаргалка кодов пригодится, когда формат диктует человек, — в письме, в отчёте, в интерфейсе; в остальных случаях стандартный формат и надёжнее, и короче. Разница между ISO-строкой и привычной датой видна в первом же сравнении — об этом урок 7.

from datetime import datetime

d = datetime(2026, 10, 21, 14, 30, 45)
print(d.isoformat())
print(d.date().isoformat())
print(d.isoformat(sep=' '))

2026-10-21T14:30:45
2026-10-21
2026-10-21 14:30:45

Буква T между датой и временем — разделитель по стандарту ISO 8601. isoformat всегда дополняет поля нулями: у datetime(2026, 10, 21, 9, 5) строка будет 2026-10-21T09:05:00 — с нулём перед девяткой и с секундами. Вызов d.date().isoformat() оставляет только календарный день без времени, а именованный аргумент sep заменяет T на любой символ: со строкой-пробелом вывод выглядит точно так же, как print(d).

Почему ISO-строки удобно сортировать

В ISO-формате поля идут от старшего к младшему: год, месяц, день, часы, минуты. Поэтому обычная строковая сортировка расставляет такие строки хронологически — не нужно парсить даты, чтобы упорядочить журнал событий или имена файлов с датами в названии. С форматом 21.10.2026 этот номер не прошёл бы: строковая сортировка поставила бы 21.09.2026 раньше 05.10.2026, потому что сравнение идёт слева направо и день важнее месяца. ISO-формат придуман так, чтобы текст и время совпадали.

stamps = ['2026-10-21', '2026-01-05', '2026-12-31', '2026-03-08']
print(sorted(stamps))

['2026-01-05', '2026-03-08', '2026-10-21', '2026-12-31']

fromisoformat: строка обратно в datetime

from datetime import datetime

d = datetime(2026, 10, 21, 14, 30, 45)
stamp = d.isoformat()
print(stamp)

restored = datetime.fromisoformat(stamp)
print(restored)
print(restored == d)

2026-10-21T14:30:45
2026-10-21 14:30:45
True

Круговая поездка честная: isoformat собрал строку, fromisoformat разобрал её обратно, и restored равен исходному d. Никакой пары «шаблон плюс данные», как в strftime, — метод узнаёт собственный формат сам, поэтому datetime.fromisoformat(d.isoformat()) можно писать не задумываясь.

from datetime import datetime

d = datetime.fromisoformat('2026-10-21')
print(d)
print(repr(d))

2026-10-21 00:00:00
datetime.datetime(2026, 10, 21, 0, 0)

isoformat закрывает хранение и передачу дат. Следующая остановка — сборка datetime из частей: combine склеивает date и time, а replace точечно меняет поля готового объекта.

Где ISO-формат работает лучше всего

Главное достоинство ISO-строки видно не в теории, а в API. Объект datetime в JSON не положишь — json.dumps на нём падает с TypeError: Object of type datetime is not JSON serializable. Два выхода: превращать дату в строку заранее или научить json.dumps её обрабатывать. Первый путь честнее: вы решаете, в каком виде дата уйдёт наружу, и не зависите от того, как сериализатор решил её представить.

import json
from datetime import datetime

d = datetime(2026, 10, 21, 14, 30)
payload = {'deal': 'поставка', 'at': d.isoformat()}

print(payload['at'])
print(json.dumps(payload, ensure_ascii=False))

2026-10-21T14:30:00
{"deal": "поставка", "at": "2026-10-21T14:30:00"}

Второе место, где ISO незаменим, — базы данных. Колонка TIMESTAMP в PostgreSQL и MySQL принимает ровно этот формат, а не «21.10.2026 14:30». Когда мы перестаём писать даты в базу через strftime с русским шаблоном, уходят целые классы ошибок: разделители, разная точность, несовпадение с тем, что потом читает другой сервис. Кто-то наверняка скажет, что база сама умеет принимать даты в куче форматов, — да, но зачем полагаться на это, если есть один формат, который понимают все?

Часовой пояс внутри ISO-строки

У осознанного момента, у которого задан часовой пояс, ISO-строка заканчивается смещением: +03:00 вместо голого времени. Это важное отличие: строка 2026-10-21T14:30:00 говорит «полдень по чьим-то часам», а 2026-10-21T14:30:00+03:00 говорит «полдень по московскому времени» — и это уже можно сравнивать с другой такой же строкой из другого пояса. Подробнее про зоны и про naive-объекты — в уроке 14.

from datetime import datetime, timedelta, timezone

msk = timezone(timedelta(hours=3))
moment = datetime(2026, 10, 21, 14, 30, tzinfo=msk)

print(moment.isoformat())

2026-10-21T14:30:00+03:00

Важно: смещение здесь фиксированное и не зависит от машины, на которой запущен код: мы явно сказали «плюс три часа». Никакой локальной зоны, никакой зависимости от настроек сервера. Если бы мы пользовались now() без явной зоны, строка получилась бы без смещения, и её нельзя было бы сравнить с датой из другого источника.

from datetime import datetime

d = datetime(2026, 10, 21, 14, 30)

try:
    print(d < '2026-10-21')
except TypeError:
    print('объект и строка несравнимы')

объект и строка несравнимы

Круговая поездка и её границы

Строку, полученную через isoformat, можно разобрать обратно — и это уже настоящая проверка: если строка не читается, значит, формат потерял информацию. Но у fromisoformat есть границы, о которых стоит знать заранее. Он понимает ISO-варианты: дату без времени, с временем, с секундами и микросекундами, со смещением. А вот «21.10.2026 14:30» — это не ISO, и такой строке он не помощник.

from datetime import datetime

restored = datetime.fromisoformat('2026-10-21T14:30:00')
print(restored)
print(restored.hour)
print(restored.minute)

2026-10-21 14:30:00
14
30

Ещё одна деталь, на которой стоит остановиться: datetime.fromisoformat в Python 3.11 и новее научился понимать большинство вариантов ISO 8601, включая букву Z на конце и смещение в форме +0300. Раньше метод принимал только узкий набор. Если ваш код должен работать на старых версиях, полагайтесь на тот формат, который пишет сам isoformat, — он распознаётся везде.

ISO-формат — это не про удобство чтения, а про то, чтобы вашу дату без споров поняла любая другая система: база, API на другом языке, скрипт в терминале.

isoformat и обратное чтение: формат, который понимают все

isoformat() существует не из-за красоты, а из-за совместимости. Строка вида «2026-10-30T18:45:00» одинаково читается в Python, JavaScript, базах данных и JSON — потому что это ISO 8601, стандарт, о котором договорились разработчики разных языков.

Обратная операция — fromisoformat() — в Python 3.11 и новее разбирает большинство вариантов ISO, включая суффикс Z и смещения часовых поясов. В 3.12 и 3.13 поведение одинаковое, но набор принимаемых вариантов различается от 3.10 и старше. Практический вывод: если код должен работать на старых версиях, полагайтесь ровно на тот формат, который пишет сам isoformat, — он распознаётся везде.

Рекомендация простая: в базе и в API храните дату в ISO, а показывайте пользователю человекочитаемую. Это убирает целый класс проблем — от «после обновления у всех отметок времени стали локальными» до невозможности сравнить даты, полученные из разных источников.

И ещё одно достоинство ISO-формата: он сортируется как текст, поэтому такие строки можно сравнивать напрямую, без разбора дат вообще.

Часы и микросекунды: сколько оставлять

У isoformat есть аргумент timespec, и он закрывает вопрос, который обычно решают вручную. По умолчанию метод пишет всё, что есть в объекте, до микросекунд. Для строки в базе это лишние шесть цифр, для метки в логе — тем более. timespec='minutes' оставляет часы и минуты, timespec='hours' — только дату и час, timespec='seconds' убирает микросекунды, но оставляет секунды.

from datetime import datetime

d = datetime(2026, 10, 21, 14, 30, 45, 123456)

print(d.isoformat())
print(d.isoformat(timespec='seconds'))
print(d.isoformat(timespec='minutes'))
print(d.isoformat(timespec='hours'))

2026-10-21T14:30:45.123456
2026-10-21T14:30:45
2026-10-21T14:30
2026-10-21T14

Выбор уровня — это договорённость с тем, кто будет читать строку. Секунды нужны там, где идут платежи и смены: там две записи с разницей в полсекунды означают разные события. Минуты достаточны для меток в логах и в расписании. А в ключе сортировки в базе часов хватает с большим запасом — суточная статистика всё равно считается запросом, а не просмотром одного значения.

Микросекунды при этом не теряются напрасно: если они в объекте есть, isoformat их запишет, и fromisoformat их прочитает обратно без потерь. Проверка на то, что ничего не потерялось, — та же круговая поездка из блока выше, только с микросекундами внутри. Мы в проектах микросекунды в строках не храним: поле microsecond в базе почти всегда бесполезно, а вот порядок событий внутри секунды по нему различать — полезно, и для этого достаточно момента в памяти, без записи в базу.