Рабочие дни: будни без выходных

Возраст и дни до события из прошлого урока считают все сутки подряд. Но планировщик живёт другими единицами: «срок через семь рабочих дней», «в месяце двадцать два рабочих дня». Календарь из урока про calendar таких чисел тоже не печатает. Хорошая новость: для базовой версии хватает двух вещей, которые уже знакомы — номеров дня недели из урока про weekday и шага timedelta из урока про разницы.

Фильтр будней: weekday() < 5

У метода weekday() есть удобное свойство: он считает с понедельника, то есть все рабочие дни — это номера от 0 до 4, а суббота и воскресенье — 5 и 6. Одно сравнение отделяет будни от выходных. Пройдём циклом неделю 19–25 октября 2026 и соберём только будни:

from datetime import date, timedelta

d = date(2026, 10, 19)   # понедельник
end = date(2026, 10, 25)  # воскресенье

workdays = []
while d <= end:
    if d.weekday() < 5:
        workdays.append(d)
    d += timedelta(days=1)

print(len(workdays))
print(workdays[0])
print(workdays[-1])

5
2026-10-19
2026-10-23

Из семи дней недели в список попали пять: с понедельника 19-го по пятницу 23-е. Обратите внимание на шаг цикла: d += timedelta(days=1) не меняет дату на месте — объекты дат неизменяемы, — а привязывает к имени d новую дату на день позже. Это тот же приём replace из прошлого урока: исходник цел, переменная смотрит на следующее значение.

Сколько рабочих дней между датами

Соберём цикл в функцию — она пригодится и для отчётов, и для следующего вопроса. Границы считаем включённо: и первый, и последний день участвуют, если не выходные.

from datetime import date, timedelta

def count_workdays(start, end):
    days = 0
    d = start
    while d <= end:
        if d.weekday() < 5:
            days += 1
        d += timedelta(days=1)
    return days

print(count_workdays(date(2026, 10, 1), date(2026, 10, 31)))
print(count_workdays(date(2026, 10, 17), date(2026, 10, 19)))
print(count_workdays(date(2026, 10, 24), date(2026, 10, 25)))

22
1
0

В октябре 2026 года 22 будня — стандартный полный месяц. Диапазон с 17 по 19 октября даёт единицу: суббота и воскресенье отсеялись, остался только понедельник. А диапазон 24–25 октября — ровно выходные, ноль рабочих дней. Три числа проверяют функцию с трёх сторон: полный месяц, диапазон с выходными внутри и диапазон из одних выходных.

Дата через N рабочих дней

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

from datetime import date, timedelta

def add_workdays(start, n):
    d = start
    while n > 0:
        d += timedelta(days=1)
        if d.weekday() < 5:
            n -= 1
    return d

print(add_workdays(date(2026, 10, 21), 1))
print(add_workdays(date(2026, 10, 21), 7))

2026-10-22
2026-10-30

Старт 21 октября 2026 — среда. Один рабочий день спустя — четверг 22-е. А семь рабочих дней — это пятница 30-го: цикл перешагнул одни выходные 24–25 октября, потому что суббота и воскресенье шагают, но счётчик не уменьшают. Сам стартовый день не считается — отсчёт начинается со следующего дня, как и ожидает заказчик от фразы «через семь рабочих дней».

from datetime import date, timedelta

def count_workdays(start, end):
    days = 0
    d = start
    while d <= end:
        if d.weekday() < 5:
            days += 1
        d += timedelta(days=1)
    return days

def add_workdays(start, n):
    d = start
    while n > 0:
        d += timedelta(days=1)
        if d.weekday() < 5:
            n -= 1
    return d

start = date(2026, 10, 21)
finish = add_workdays(start, 7)
print(finish)
print(count_workdays(start, finish - timedelta(days=1)))

2026-10-30
7

Что дальше

Одна дата за раз — это ручной труд. Когда дат становятся десятки и они приезжают таблицей, циклы заменяет pandas: следующий урок — даты в Pandas через to_datetime, где столбец строк одним вызовом превращается в настоящие даты, а фильтры по периоду становятся сравнениями.

Условие d.weekday() < 5 честно работает до первого производственного календаря: праздники оно не знает и не угадает.

Границы периода решают всё

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

from datetime import date, timedelta

start = date(2026, 10, 26)
end = date(2026, 10, 30)

d = start
while d <= end:
    print(d.isoformat(), d.strftime('%a'), d.weekday())
    d += timedelta(days=1)

2026-10-26 Mon 0
2026-10-27 Tue 1
2026-10-28 Wed 2
2026-10-29 Thu 3
2026-10-30 Fri 4

Пять дней подряд, с понедельника по пятницу, номера от 0 до 4 — ровно то, что отсекает условие weekday() < 5. Заметьте, что strftime с шаблоном %a даёт английские сокращения: Monday, Tuesday. Русские названия дней недели в datetime живут отдельным словарём, о нём шла речь в уроке про дни недели. Числа в этом виде уже пригодны для выгрузки в CSV или JSON — и, в отличие от объектов date, они сериализуются без плясок.

Производственный календарь: свой справочник

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

from datetime import date, timedelta

holidays = {date(2026, 11, 4)}

def count_workdays(start, end):
    days = 0
    d = start
    while d <= end:
        if d.weekday() < 5 and d not in holidays:
            days += 1
        d += timedelta(days=1)
    return days

print(count_workdays(date(2026, 11, 1), date(2026, 11, 30)))

20

Ноябрь 2026 года без праздников дал бы 21 рабочий день, а с 4 ноября — государственным выходным — получается 20. Проверка d not in holidays стоит ровно столько же, сколько weekday() < 5, и не ломает ничего: множество дат ищется за O(1), а сам цикл по-прежнему идёт по дням.

from datetime import date

holidays = {date(2026, 11, 4)}

def is_business_day(d):
    return d.weekday() < 5 and d not in holidays

for d in (date(2026, 11, 3), date(2026, 11, 4), date(2026, 11, 7)):
    print(d.isoformat(), is_business_day(d))

2026-11-03 True
2026-11-04 False
2026-11-07 False

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

Оптимизация, которая обычно не нужна

Цикл из урока шагает по одному дню и на выходных просто не уменьшает счётчик. За год — 365 итераций, за десять лет — 3650. Это ничто: на нашем ноутбуке такой подсчёт укладывается в десятки микросекунд, и заметить разницу можно только бенчмарком. Но если очень хочется, выходные можно перепрыгивать целиком.

from datetime import date, timedelta

def add_workdays_fast(start, n):
    d = start
    while n > 0:
        d += timedelta(days=1)
        if d.weekday() == 5:
            d += timedelta(days=2)
            n -= 1
        elif d.weekday() == 6:
            d += timedelta(days=1)
            n -= 1
        else:
            n -= 1
    return d

def add_workdays_plain(start, n):
    d = start
    while n > 0:
        d += timedelta(days=1)
        if d.weekday() < 5:
            n -= 1
    return d

for n in (1, 5, 7, 20):
    print(n, add_workdays_fast(date(2026, 10, 21), n), add_workdays_plain(date(2026, 10, 21), n))

1 2026-10-22 2026-10-22
5 2026-10-28 2026-10-28
7 2026-10-30 2026-10-30
20 2026-11-18 2026-11-18

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

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

from datetime import date, timedelta

def count_workdays(start, end):
    days = 0
    d = start
    while d <= end:
        if d.weekday() < 5:
            days += 1
        d += timedelta(days=1)
    return days

def add_workdays(start, n):
    d = start
    while n > 0:
        d += timedelta(days=1)
        if d.weekday() < 5:
            n -= 1
    return d

start = date(2026, 10, 21)
finish = add_workdays(start, 12)

print(finish)
print(count_workdays(start + timedelta(days=1), finish))

2026-11-06
12

Здесь граница сдвинута на день: стартовый день не входит в отсчёт, поэтому при обратной проверке мы начинаем со следующего дня. Если этого не сделать, получится 13 вместо 12 — тот самый сдвиг на единицу, о котором шла речь в питфолле выше. Взаимная проверка занимает четыре строки и ловит ровно те ошибки, которые не видны в коде.