datetime в Python: первый момент времени

Дата в жизни программы почти всегда приезжает строкой: «21.10.2026» из лога, «2026-10-21» из формы, «завтра в 12:00» из письма. Пока дата — строка, с ней нельзя сделать ничего осмысленного: две даты честно не сравнить, неделю к ним не прибавить, разницу не посчитать. Модуль datetime из стандартной библиотеки решает это на корню: дата и время становятся объектами, а объекты уже умеют и сравниваться, и считать. Начинаем раздел с главного — создания первого момента.

Первый объект datetime

Сначала маленькая тонкость, которая путает всех новичков: datetime — это и имя модуля, и имя класса внутри него. Строка from datetime import datetime читается тавтологией, но смысл простой: из модуля datetime импортируем класс datetime. Именно класс создаёт моменты: datetime(2026, 10, 21, 12, 0) — двадцать первое октября 2026 года, полдень. Аргументы идут в строгом порядке: год, месяц, день, час, минута, секунда. Часы и минуты можно опустить — получится полночь, и момент всё равно полноценный. Поля момента читаются через точку: year, month, day, hour, minute, second; записать новое значение нельзя — объект неизменяем, новый момент строится новым вызовом.

from datetime import datetime

moment = datetime(2026, 10, 21, 12, 0)
print(moment)

no_time = datetime(2026, 10, 21)
print(no_time)

2026-10-21 12:00:00
2026-10-21 00:00:00

from datetime import datetime

moment = datetime(2026, 10, 21, 12, 0)

print(moment.year)
print(moment.month)
print(moment.day)
print(moment.hour)
print(moment.minute)
print(moment.second)

2026
10
21
12
0
0

Как datetime печатает себя

from datetime import datetime

moment = datetime(2026, 10, 21, 12, 0)

print(moment)
print(repr(moment))
print([moment])

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

У даты два лица: print показывает момент ISO-строкой, а repr — вызовом конструктора, по которому объект восстанавливается один в один. По repr из traceback-а сразу видно, какой именно момент лежал в переменной, а ISO-строка сортируется правильно — к сортировке мы вернёмся в уроке 7. Строкам же доверять не стоит: выражение '9.10.2026' > '10.10.2026' вернёт True, потому что строки сравниваются посимвольно, и девятка выигрывает у единицы. Честное сравнение дат устроим позже — для него и нужны объекты.

Что лежит внутри объекта datetime

Под капотом datetime хранит не строку, а набор целых чисел: год, месяц, день, час, минута, секунда и микросекунды. Плюс два служебных поля — часовой пояс (у наших объектов он пустой, такие моменты называют наивными) и признак fold, который различает повторяющийся час при переходе на летнее время. Отсюда два следствия, полезные дальше. Первое: сравнение моментов не превращает их в текст, поэтому оно быстрое и не зависит от локали машины. Второе: два момента с одинаковыми полями равны, хотя в памяти это разные объекты, а значит, datetime годится на роль ключа словаря.

from datetime import datetime

moment = datetime(2026, 10, 21, 14, 30, 0, 123456)

print(moment.microsecond)
print(moment.tzinfo)
print(moment == datetime(2026, 10, 21, 14, 30, 0, 123456))
print(moment < datetime(2026, 10, 22))

123456
None
True
True

Микросекунды в обычной жизни почти не видны: у момента, собранного руками, их ноль, и печать выглядит как 2026-10-21 14:30:00. Ненулевые микросекунды появляются у now() — часы компьютера умеют фиксировать момент точнее секунды. Само поле существует всегда, просто чаще всего равно нулю. Отдельно про tzinfo: он равен None, потому что мы не сказали объекту, в каком часовом поясе живёт этот момент. Наивные моменты хороши тем, что не требуют вози с зонами, — но смешивать их с осознанными нельзя, об этом урок про часовые пояса.

Месяц и день местами: ошибка, которую видно не сразу

Конструктор принимает месяц первым, а в русской записи день идёт первым: 21.10.2026 читается как двадцать первое октября, а datetime ждёт (год, месяц, день). Перепутать их легко, и вот что неприятно. Если в день попало число больше двенадцати, Python честно падает с ValueError — мимо такого не пройти. А если числа маленькие, например 5 и 10, объект создаётся, и дата получается ровно противоположная той, о которой думал человек. Никакой ошибки, никакого предупреждения: в отчёте за март внезапно оказывается пять октября, и считать выручку приходится вручную.

from datetime import datetime

print(datetime(2026, 5, 10))
print(datetime(2026, 10, 5))

2026-05-10 00:00:00
2026-10-05 00:00:00

Объект неизменяем — и это скорее подарок

Попытка изменить поле у готового момента заканчивается ошибкой: у datetime нет сеттеров. Поначалу это раздражает — хочется взять объект из словаря и поправить в нём час. Но вдумайтесь, что было бы, если бы это было возможно: объект лежит сразу в пяти местах, и любая правка молча поменяла бы все пять. С датами такого не хочется. Срок платежа, привязанный к записи, должен остаться тем же самым в логе, в отчёте и в письме. Поэтому datetime устроен как строки и кортежи: любой изменяющий метод возвращает новый объект. Приём называется replace, ему посвящён урок 11.

from datetime import datetime

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

try:
    moment.year = 2027
except AttributeError:
    print('поле менять нельзя')

print(moment.year)

поле менять нельзя
2026

Сегодня ты создал первый момент — datetime(2026, 10, 21, 12, 0), разобрал его на атрибуты и научился читать оба его представления. Дальше по курсу: урок 2 — три класса модуля: date без часов, time без даты и момент целиком; урок 3 — now и today: как получить настоящий текущий момент, а не фиксированный.

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