now и today: текущий момент

Все даты в первых двух уроках созданы руками: datetime(2026, 10, 21, 12, 0) и близнецы. Настоящей «сейчас»-даты среди них нет, и это не случайность, а дисциплина: сейчас-дата — единственное значение в модуле, которое нельзя предсказать заранее. Разберёмся, как её получать и что из этого следует.

datetime.now(): момент по часам компьютера

Метод now() принадлежит самому классу datetime: вызывается не у объекта, а у класса, и возвращает новый объект с текущими значениями полей. Поля знакомые — year, month, day, hour, minute — просто теперь они честные, на момент вызова.

from datetime import datetime

moment = datetime.now()

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

2026-10-23 14:37:12.084521
2026 10 23
14 37

В выводе появилось то, чего не было раньше: микросекунды. now() знает момент точнее секунды — 12.084521 означает «12 секунд и 84 521-я микросекунда». Для меток в логах это ровно то, что нужно. Кстати, у datetime есть и метод today() — без аргументов это синоним now(); историческое имя осталось с тех времён, когда о часовых поясах в модуле ещё не думали. Настоящие различия между ними начнутся в уроке 14.

date.today(): только сегодня

Если нужен только календарный день, время в выводе — шум. У класса date есть собственный метод today(): сегодняшняя дата без часов. Поля у результата знакомые — year, month, day; времени суток здесь нет и быть не может: сегодня — это дата, а для «сегодня в 14:37» нужен datetime.now() или его метод .time() из урока 2.

from datetime import date

today = date.today()

print(today)
print(today.year, today.month, today.day)

2026-10-23
2026 10 23

Четыре лица текущего момента

Один и тот же «сейчас» можно разобрать на четыре части, и выбор зависит от того, что вы с ним собираетесь делать. День без часов удобен там, где вы сравниваете даты с границами периода: лишнего времени в объекте date просто нет, и ошибиться не с чем. Полный момент нужен, когда важна последовательность событий, а время без даты — когда дата лежит в соседнем поле. Отдельно стоит заметить, что date.today() и datetime.now().date() дают одинаковый результат: второй просто длиннее. В рабочем коде мы берём короткий.

Почему в примерах курса фиксированные даты

Каждый код-блок на этой странице можно запустить и сверить вывод, а с now() фокус не выйдет. Вывод меняется от запуска к запуску, поэтому в проверяемых примерах курса даты фиксированные, а «сейчас» подставляется переменной. По-настоящему now() и today() незаменимы там, где предсказуемость и не нужна: метки в логах, «дней до дедлайна» в интерфейсе, отчёты «за сегодня». Смотрим на подсчёт дней до релиза: код выглядит ровно как в настоящем приложении, только вместо настоящего now — подставная дата.

from datetime import datetime

now = datetime(2026, 10, 23, 14, 37)   # подставное «сейчас»
release = datetime(2026, 11, 1, 12, 0)

left = release - now
print(left)
print(left.days)

8 days, 21:23:00
8

now() лучше передавать функции, а не звать внутри

С подставной датой есть одна неочевидная выгода, которую стоит назвать прямо. Если функция принимает текущий момент аргументом, её можно вызвать с любой датой — и проверить, что она считает правильно. Если же она сама зовёт datetime.now() внутри, проверить её нечем: результат зависит от того, в какой миллисекунде запустили тест. Проверка на две разные даты вместо одной — уже два теста. Мы в рабочих проектах держим правило: функции, которые считают дни и сроки, принимают now параметром, а вызов datetime.now() живёт в одном месте — там, где функцию зовут.

from datetime import datetime


def days_until(target, now):
    return (target - now).days


release = datetime(2026, 11, 1, 12, 0)
now = datetime(2026, 10, 21, 14, 30)

print(days_until(release, now))

10

Читается такой код чуть длиннее, чем одна строка с now() внутри, зато проверяется честно. Побочный эффект приятный: функцию days_until можно вызвать с граничными значениями — за день до срока, за минуту до, ровно в срок — и получить осмысленные числа вместо «сегодня примерно десять дней назад».

Граница суток: почему «вчера» иногда не вчера

Ещё одна штука, на которой спотыкаются даже опытные: сутки заканчиваются в полночь, а не в 23:59, и «сегодня» меняется в 00:00. Если вы в полночь тридцать минут спросите у now() дату, получите один день, а отнимете от неё час — уже другой. Для счётчиков «дней до дедлайна» это обычно безобидно, а вот в отчётах за период может дать сдвиг на строку. Обратная сторона: тот же now() в 23:59 и в 00:01 даёт две разные даты, хотя прошёл всего минута.

from datetime import datetime, timedelta

now = datetime(2026, 10, 21, 0, 30)

print(now.date())
print((now - timedelta(hours=1)).date())

2026-10-21
2026-10-20

from datetime import datetime

first = datetime(2026, 10, 21, 14, 30, 0, 100000)
second = datetime(2026, 10, 21, 14, 30, 0, 200000)

print(first == second)
print(second - first)

False
0:00:00.100000

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

Ещё один вопрос, который стоит закрыть сразу: local или UTC отдаёт now()? Отвечает локальная зона машины — тот часовой пояс, который настроен в системе. На сервере в Европе это может быть другой пояс, чем у пользователя в Москве, и тот же самый now() на двух машинах даст разные моменты. Про часовые пояса — отдельный урок 14, а пока держите в голове: datetime.now() без всяких дополнительных настроек означает «как настроены часы этой машины».

now() в коде: почему его результат нельзя зашивать в тест

Функция now() настолько естественна, что её результат рано или поздно попадает в тест или в сохранённые данные. И там он становится проблемой: значение, которое было правильным вчера, сегодня уже другое, и «сломанный» тест на самом деле проверяет не логику, а время.

Отсюда правило, которое стоит записать: если результат now() попадает в данные, которые должны быть стабильными, — вычисляйте «сейчас» один раз на границе программы и передавайте дальше явно. Тогда и тест, и лог будут воспроизводимы.

Второй приём — подмена «сейчас» на фиксированную дату в тестах: передавайте в функцию не datetime.now(), а конкретный момент. Это дешёвый рефакторинг, который превращает хрупкий тест в устойчивый.