strftime: дата превращается в строку

Для вычислений объект из прошлых уроков идеален, но наружу его так не отдашь: пользователю нужна «21.10.2026», отчёту — «2026-10-21», письму — «21 октября». Печатать дату руками из шести полей — значит склеивать нули и переживать о точках. В Python это одна строка: метод strftime, «string from time» — строка из времени.

Шаблон из кодов

strftime принимает шаблон — обычную строку, в которой специальные коды со знаком процента заменяются значениями полей. Код в шаблоне заменяется значением поля, а все остальные символы — точки, дефисы, пробелы — печатаются как есть. Главные коды: %d — день, %m — месяц, %Y — год с веком, каждый двумя цифрами, где нужно.

from datetime import datetime

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

print(moment.strftime('%d.%m.%Y'))
print(moment.strftime('%Y-%m-%d'))
print(moment.strftime('%d.%m.%Y %H:%M'))

21.10.2026
2026-10-21
21.10.2026 12:00

Время в шаблоне

from datetime import datetime

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

print(moment.strftime('%H:%M'))
print(moment.strftime('%H:%M:%S'))
print(moment.strftime('%d.%m.%Y, %H:%M'))

12:00
12:00:00
21.10.2026, 12:00

К %d.%m.%Y добавились коды времени: %H — часы от 00 до 23, %M — минуты, %S — секунды, тоже с ведущими нулями: в 9:05 утра %H:%M даст «09:05». Метод возвращает строку и ничего не меняет в самом объекте — strftime можно вызывать хоть десять раз с разными шаблонами. Работает он и у date: date(2026, 10, 21).strftime('%d.%m.%Y') даст «21.10.2026».

Названия месяцев и дней: честно про локаль

from datetime import datetime

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

print(moment.strftime('%B'))
print(moment.strftime('%b'))
print(moment.strftime('%A, %d %B %Y'))

October
Oct
Wednesday, 21 October 2026

Коды %B и %b — полное и краткое название месяца, %A и %a — название дня недели. Подставляются они по локали среды, где исполняется код: в песочнице на этой странице локаль английская, поэтому October и Wednesday — а не «Октябрь» и «среда». О том, как получить русские названия и собрать «21 октября 2026», — целый урок 9; полная таблица всех кодов форматирования ждёт в уроке 8.

Один объект — сколько угодно строк

Самое частое применение strftime в рабочем коде — один и тот же момент превращается в разные строки для разных потребителей. Отчёт для бухгалтерии, строка в лог, подпись в письме, имя файла: момент один, форматов четыре. Держите объект и форматируйте на выходе, а не на входе — тогда любая правка шаблона не ломает расчёты.

from datetime import datetime

moment = datetime(2026, 10, 21, 9, 5, 7)

print(moment.strftime('%d.%m.%Y'))
print(moment.strftime('%Y-%m-%d'))
print(moment.strftime('%d.%m.%Y %H:%M:%S'))
print(moment.strftime('%H:%M'))

21.10.2026
2026-10-21
21.10.2026 09:05:07
09:05

Шаблоны выносят в константы

Как только шаблон используется в двух местах, он заслуживает имени. Строки с процентами прямо в коде — это классика, из-за которой через год никто не может сказать, что значит %d.%m.%Y в конкретном отчёте. Мы в проектах держим константы с именами, говорящими о назначении, а не о виде: DATE_FORMAT для даты, ISO_FORMAT для машинного формата. Правило простое — если шаблон повторился дважды, у него должно быть имя.

from datetime import datetime

DATE_FORMAT = '%d.%m.%Y'
ISO_FORMAT = '%Y-%m-%d'

moment = datetime(2026, 10, 21)
print(moment.strftime(DATE_FORMAT))
print(moment.strftime(ISO_FORMAT))

21.10.2026
2026-10-21

from datetime import datetime

moment = datetime(2026, 10, 21)

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

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

Где это нужно на практике: имя файла и подпись

Случай, где формат выбирают не для красоты, а чтобы сортировка работала. Выгрузку за вчера кладут в файл report_2026-10-21.csv — и папка с выгрузками за месяц сортируется по дате сама, без всякой разметки. Формат %Y-%m-%d здесь единственный разумный: он монотонный, а русский %d.%m.%Y в имени файла дал бы report_05.10.2026.csv рядом с report_12.09.2026.csv, и по алфавиту они встали бы не в том порядке.

from datetime import datetime

moment = datetime(2026, 10, 21, 9, 5)

name = 'report_' + moment.strftime('%Y-%m-%d') + '.csv'
print(name)

report_2026-10-21.csv

Отдельно про имя файла: двоеточие в нём использовать нельзя — на Windows это запрещённый символ, и файл просто не создастся. Тот же %H:%M в шаблоне выдаст «14:30», а для имени файла приходится писать %H-%M или %H%M. Мелочь, на которую уходит час, когда в проде впервые падает выгрузка.

Шаблон — это не украшение, а контракт: он решает, в каком виде дата попадёт в лог, в отчёт или в имя файла, и потому меняется вместе с требованиями к этим трём вещам.

Коды, результат которых зависит от машины

Большинство кодов strftime ведут себя одинаково везде: %d.%m.%Y даст «21.10.2026» и на ноутбуке, и в контейнере. Но есть исключения, и они кусаются именно там, где код кажется простым. Код %c печатает дату и время в формате, заданном операционной системой: у нас он даёт «Wed Oct 21 14:30:45 2026», а на другой машине с другой локалью — другой вид. Тот же случай у %x (дата) и %X (время): сейчас это «10/21/26» и «14:30:45», но в другой локали придёт «21.10.26».

Ловушка здесь в том, что на своей машине такой код выглядит вполне рабочим: он печатает, выглядит осмысленно, никто его не проверяет. Ошибка всплывает на другой машине — в CI, на сервере, у коллеги. И выглядит это как «вчера работало, сегодня сломалось», хотя код не менялся.

Отдельная история — код %Z с именем часового пояса. У момента без привязки к зоне он пустой, у осознанного момента отдаёт что-то вроде MSK, и это значение тоже зависит от того, как настроена система. Для имени зоны у нас есть только один надёжный источник: tzinfo самого объекта. Всё, что связано с зонами, разбирается в уроке 14, а здесь достаточно понимать, что %Z в шаблоне — это не то, что можно класть в сравнение.

Проверка, которая закрывает вопрос раз и навсегда: если строка из шаблона уходит в базу, в лог или в API — она должна сортироваться как дата и разбираться обратно без потерь. %Y-%m-%d %H:%M удовлетворяет обоим условиям, %c не удовлетворяет ни первому, ни второму. Мы держим в проектах одно правило: шаблон либо перечисляет поля сам, либо это isoformat(). Всё остальное — для глаз, а не для хранения.