Коды форматирования strftime: полная шпаргалка

Объект datetime удобен коду: из него достаются month и hour, он сравнивается и вычитается. Человеку же нужна строка — «21.10.2026 14:30» на экране, в письме, в имени файла. Для превращения datetime в строку у него есть метод strftime: он получает шаблон, собранный из кодов, и каждый код начинается с процента. Это полная шпаргалка по кодам форматирования — вернитесь к ней, когда в очередной раз забудется, чем %m отличается от %M.

from datetime import datetime

d = datetime(2026, 10, 21, 14, 30, 45)
print(d.strftime('%d.%m.%Y %H:%M'))
print(d.strftime('%A, %d %B'))

21.10.2026 14:30
Wednesday, 21 October

Метод читается как string format time: он получает шаблон и возвращает строку, где каждый код заменён своей частью даты. %d — день, %m — месяц, %Y — год, %H и %M — часы и минуты. Всё остальное — точки, пробелы, запятые, любые буквы — остаётся в строке как написано: шаблон '%A, %d %B' дал Wednesday, 21 October именно потому, что запятая с пробелами — не коды. Заметьте: %A и %B вывели английские названия. Откуда они берутся и как получить русские — отдельная история, ей посвящён урок про русские даты.

Полная таблица кодов

Все примеры сняты с одной подопытной даты — datetime(2026, 10, 21, 14, 30, 45), это среда, объект без микросекунд. От содержимого объекта зависят два кода: %f выводит микросекунды шестью цифрами, и у объекта без них получится 000000; %j — номер дня в году, у 21 октября 2026-го это 294-й день.

from datetime import datetime

d = datetime(2026, 10, 21, 14, 30, 45)
codes = ['%Y', '%y', '%m', '%d', '%H', '%M', '%S']
for c in codes:
    print(c, '->', d.strftime(c))

%Y -> 2026
%y -> 26
%m -> 10
%d -> 21
%H -> 14
%M -> 30
%S -> 45

Код %m выводит месяц, а %M — минуты: регистр один, а значения разные. Это самая частая опечатка в strftime, и она не вызывает ни ошибки, ни предупреждения: шаблон '%m:%d' честно напечатает 10:21 там, где ждали минуты с часами. Программа работает, дата — неправильная, а заметят это обычно уже на проде. Родственная оговорка про то, как вывести день недели текстом, — в уроке про weekday.

from datetime import datetime

d = datetime(2026, 10, 21, 14, 30)
print(d.strftime('%m'))
print(d.strftime('%M'))

10
30

Отдельная пара — %H и %I: первый выводит часы в 24-часовом формате от 00 до 23, второй — в 12-часовом от 01 до 12. Код %I обычно идёт в паре с %p, который добавляет обозначение AM или PM: без него 02:30 не понять, утро это или день. Четырнадцать часов тридцать минут в 12-часовой записи — это 02:30 PM.

from datetime import datetime

d = datetime(2026, 10, 21, 14, 30, 45)
print(d.strftime('%I:%M %p'))

02:30 PM

Коды за пределами даты: неделя, год, эпоха

В таблице выше лежат коды, которыми пользуются постоянно. Но есть ещё несколько, и они закрывают задачи, которые регулярно всплывают в отчётности. День года %j нужен для нумерации страниц отчёта и для расчёта «прошло ли столько-то дней с начала года». Коды недели %U и %W считают недели по-разному: %U начинает неделю с воскресенья, %W — с понедельника, и для одной и той же даты числа могут отличаться.

from datetime import datetime

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

print(d.strftime('%j'))
print(d.strftime('%U'))
print(d.strftime('%W'))
print(d.strftime('%G'))
print(d.strftime('%V'))

294
42
42
2026
43

Коды %G и %V — это ISO-версия: %G даёт год по стандарту ISO 8601, а %V — номер недели в нём. Именно из-за ISO тут возникает неочевидная вещь: новый календарный год может начаться внутри старой недели. Первое января 2027 года ISO считает 53-й неделю 2026-го года.

from datetime import date

d = date(2027, 1, 1)
year, week, weekday = d.isocalendar()

print(d.year)
print(year, week)

2027
2026 53

Собирать шаблон из кусков

Когда один и тот же формат нужен в нескольких местах — в подписи и в имени файла, например, — его удобно собирать из кусков. Дата и время живут отдельными константами, а полная строка получается их склейкой. Это не изобретение: так же устроены ISO-форматы в большинстве языков, и тот же приём пригодится, когда формат нужно немного менять в зависимости от контекста.

from datetime import datetime

DATE_FORMAT = '%d.%m.%Y'
TIME_FORMAT = '%H:%M'

moment = datetime(2026, 10, 21, 14, 30)
print(moment.strftime(DATE_FORMAT + ' ' + TIME_FORMAT))

21.10.2026 14:30

И последнее про проценты. В шаблоне strftime символ % означает начало кода, поэтому процент в обычном тексте удваивается: 'скидка %d%%' напечатает «скидка 21%». Одинокий % в конце шаблона — ошибка: в Python 3.13 и новее это ValueError: Invalid format string, в более старых версиях знак иногда молча пропадал, в зависимости от системы. Случается это нечасто, но в отчётах со скидками и процентами — регулярно, и ошибка прилетает уже на проде.

from datetime import datetime

moment = datetime(2026, 10, 21)

print(moment.strftime('скидка %d%%'))
print(moment.strftime('скидка %d%% на всё'))

скидка 21%
скидка 21% на всё

Шпаргалка по кодам полезна ровно до того момента, когда вы перестаёте в неё заглядывать: пара «%m — месяц, %M — минуты» запоминается за час и ошибается в одном проекте за всю жизнь.