date, time и datetime: три класса

datetime из первого урока хранит всё сразу — и календарь, и часы. Но не каждой задаче нужно всё: у дня рождения часов нет, у будильника нет календаря, а у записи в логе есть и то и другое. Держать «просто дату» в полноценном datetime — как хранить рост человека вместе с историей его стрижек: можно, но зачем. Поэтому в модуле datetime живут три класса под три разных задачи.

Три класса одного модуля

Знакомимся: date(2026, 10, 21) — только год, месяц и день; time(12, 30) — только часы, минуты и секунды, без всякого календаря; datetime — момент целиком, обе половины сразу. Печатаются они по-разному: date — ISO-датой, time — временем суток через двоеточия, datetime — склейкой обеих частей через пробел. Атрибуты делятся так же: у date — year, month, day; у time — hour, minute, second; datetime держит все шесть. И граница между классами настоящая: спросить у date, который час, не выйдет.

from datetime import date, datetime, time

print(date(2026, 10, 21))
print(time(12, 30))
print(datetime(2026, 10, 21, 12, 30))

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

Извлекаем части: date() и time()

from datetime import datetime

meeting = datetime(2026, 10, 21, 12, 30)

print(meeting.date())
print(meeting.time())
print(type(meeting.date()))
print(type(meeting.time()))

2026-10-21
12:30:00
<class 'datetime.date'>
<class 'datetime.time'>

date() и time() не режут строку — они возвращают настоящие объекты соответствующих классов, со всеми полями и методами. Из даты встречи можно взять месяц (meeting.date().month), из времени — секунды (meeting.time().second), и всё это честные числа. Обратная сборка — из date и time сделать datetime — называется combine, и ей посвящён урок 11; сегодня важно само умение разбирать момент на части.

Какой класс выбрать

Правило простое: выбирай самый узкий класс, которого хватает задаче. День рождения — date: отмечается по календарю, а не по часам. Начало рабочего дня — time. А «заказ оформлен 21 октября в 12:30» — datetime, потому что без обеих частей событие не опишешь.

Одна минута: datetime — это подкласс date

Есть деталь, на которой спотыкаются даже опытные разработчики: datetime — не сосед date, а его подкласс. Проверка isinstance намекает на это сама собой, но в коде это означает совершенно конкретную ловушку. Если вы перебираете разнородные записи и спрашиваете isinstance(x, date), то моменты datetime тоже подойдут — isinstance вернёт True, потому что момент и правда date, просто с добавленным временем. На практике это приводит к тому, что код, который якобы отделяет даты от моментов, на самом деле не отделяет ничего.

from datetime import date, datetime

items = [date(2026, 10, 21), datetime(2026, 10, 21, 14, 30)]

for item in items:
    if isinstance(item, date):
        kind = 'дата'
    else:
        kind = 'момент'
    print(kind, item)

дата 2026-10-21
дата 2026-10-21 14:30:00

Второй объект — момент с временем, а код назвал его датой. Лечится перестановкой: сначала спрашиваем про более узкий класс, потом про более широкий. Проверка на datetime идёт первой, и тогда каждый объект попадает в свою корзину.

from datetime import date, datetime

items = [date(2026, 10, 21), datetime(2026, 10, 21, 14, 30)]

for item in items:
    if isinstance(item, datetime):
        kind = 'момент'
    elif isinstance(item, date):
        kind = 'дата'
    print(kind, item)

дата 2026-10-21
момент 2026-10-21 14:30:00

Смешивать классы в сравнениях нельзя

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

from datetime import date, datetime

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

try:
    print(d < m)
except TypeError:
    print('Ошибка: классы разные, сравнение невозможно')

print(date(2026, 10, 21) < date(2026, 10, 22))

Ошибка: классы разные, сравнение невозможно
True

Текст ошибки Python менялся от версии к версии: в 3.12 сообщение выглядело как «can't compare datetime.datetime to datetime.date», в 3.13 — как «'<' not supported between instances of 'datetime.date' and 'datetime.datetime'». Поэтому в рабочем коде ориентируйтесь на сам тип исключения, TypeError, а не на формулировку: перехватывайте класс ошибки, а не сравнивайте строки. В примере выше мы так и сделали — поймали TypeError и напечатали свою строку, поэтому вывод одинаков в любой версии.

Приём, который мы используем в проектах: привести всё к одному классу на входе. Если в системе даты и моменты лежат рядом, приводите моменты к датам через .date() — и сравнивайте даты. Обратный путь, от даты к моменту, требует указания времени и делается вручную или через combine, о котором пойдёт речь в уроке 11.

from datetime import date, datetime

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

print(m.date() < date(2026, 10, 22))
print(d == m.date())

True
True

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

Обратное преобразование: из двух полей — один момент

Раз date и time не превращаются друг в друга, момент приходится собирать из кусков. Способов два. Первый — ручной: взять год, месяц и день у даты, часы и минуты у времени и передать их конструктору. Работает, но требует внимания: забытый аргумент сдвигает момент на полночь. Второй — datetime.combine, который делает то же самое одной строкой и заодно проверяет, что на вход поданы объекты правильных классов. Второй способ мы предпочитаем почти всегда: он короче и не ошибается в порядке аргументов.

from datetime import date, datetime, time

d = date(2026, 10, 21)
t = time(14, 30)

manual = datetime(d.year, d.month, d.day, t.hour, t.minute)
print(manual)

print(datetime.combine(d, t))

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

date — календарь без часов, time — часы без календаря, datetime — момент целиком: самый узкий класс, которого хватает задаче, и есть правильный.