Календарь праздников: годовые таблицы в коде

Табло над входом в гараж я собрал за один вечер: DS3231, матрица из дешёвых светодиодов, план простой — в Новый год бегущая волна, 23 февраля и 8 марта короткое приветствие, в остальные дни просто часы. Первая версия была написана так, как пишут в первый раз: лестница из условий, по ветке на каждый праздник. К апрелю лестница стала семиэтажной, и в ней обнаружилась опечатка, которую я не видел две недели: день Победы был вбит как 3 мая. Табло честно поздравило меня третьего мая, а девятого промолчало, и я узнал об этом от соседа по гаражу, а не от своего кода.

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

Нерабочие праздничные дни российского производственного календаря перечислены в статье 112 Трудового кодекса, и их удобно пересчитать пальцами: восемь дней январских каникул с 1 по 8 января плюс шесть отдельных дат — 23 февраля, 8 марта, 1 мая, 9 мая, 12 июня, 4 ноября. Итого четырнадцать дней в году. Хранить их дешевле всего парой параллельных массивов: в одном месяцы, во втором дни, в третьем — названия для печати. Восемь уникальных дат по два байта каждая — шестнадцать байт ОЗУ, меньше, чем одна строка на экране. Январь отдельно: 2, 3, 4, 5, 6 и 8 января — это не список, а сплошной диапазон, и проверять его честнее одним условием вида «месяц первый и день от двух до восьми», чем восемью строками, где легко промахнуться.

Проверка «сегодня праздник?» — один проход цикла: достаём из объекта DateTime месяц и день, сравниваем с каждой парой таблицы, при совпадении запоминаем индекс. По индексу достаём название. Поля объекта я разбирал в уроке про DateTime — здесь понадобятся только month() и day(). День недели тоже пригодится: метод dayOfTheWeek() возвращает 0…6, причём ноль — понедельник, и это готовый индекс в массив из семи названий «понедельник…воскресенье». В симуляторе я это поведение проверил явно: 8 марта 2025 года вернуло пятёрку — суббота.

Таблица живёт в ОЗУ вместе с кодом, и на Uno её цена смешная: шестнадцать байт на даты и десятки — на строки имён. Если проект упирается в потолок двух килобайт, даты уезжают во флеш-память через PROGMEM и читаются оттуда по требованию — приём разобран в уроке про PROGMEM. Второй резерв экономии — сами строки имён: «Den Pobedy» без падежей и кириллицы короче вдвое, и это не только про память: LCD-экран без перепрошивки знакогенератора кириллицу всё равно не покажет, так что латиница в таких проектах — осознанный выбор, а не костыль.

Две детали скетча, на которых спотыкаются. Первая — delay() на 3 600 000 мс здесь стоит только ради простоты: час тишины в loop значит, что кнопку или датчик код в это время не видит, и для настоящего устройства проверку даты встраивают в миллис-планировщик — как в уроке про задачи на millis. Вторая — строка lostPower() в setup: календарь бессмыслен, если часы после отключения питания показывают нули, поэтому сначала проверяем, не потеряло ли время ход, и при необходимости заводим его заново. Саму механику adjust и его ловушки я разбирал в уроке про первый скетч с RTClib — там же про то, почему adjust при каждой загрузке перезаписывает честно тикающие часы.

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

Отсчёт «до Нового года осталось N дней» строится на второй таблице — накопительном числе дней от начала года: январь 31, февраль 59, март 90, апрель 120 и так далее до 365. День года = значение для прошлого месяца плюс число дня. Поправка на високосный год — классическое правило: год делится на 4, кроме кратных 100, если только они не кратны 400. Значит, 2024 и 2028 високосные, а 2100 — нет, и для устройства, которое переживёт два века, поправка уже написана правильно: один лишний день добавляем только если месяц старше февраля. Дальше арифметика: разность номеров дней в году, и если она ушла в минус — прибавляем длину года, потому что ближайший такой праздник уже в следующем году. 31 декабря отсчёт честно показывает «до Нового года 1 день». Если счётчик живёт на дисплее, пересчитывайте его раз в час: значения меняются раз в сутки, и бегать циклом по восьми датам каждый loop — трата тактов, пусть и смешная.

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

В симуляторе «сегодня» подставлено строкой rtc.adjust с фиксированной датой — это демо-приём, а не рекомендация для платы: там дата приходит из батареечных часов сама, и про её сохранность после отключений я писал в уроке про millis и RTC. Поменяйте месяц и день в adjust, запустите заново — вердикт и отсчёт пересчитаются. Честная оговорка про движок: время после запуска стоит на месте, как стоп-кадр, секунды не тикают — для проверки календарной логики этого достаточно, потому что проверка смотрит только на месяц и день. Цикл по таблице движок считает по-настоящему, поэтому вердикт здесь — не имитация, а тот же код, что на плате. Функции pad2 и doy в симуляторе ровно те же, что и в скетче для платы выше, — календарная часть переезжает в железо без правок. И проверьте глазами високосную ветку: поставьте в adjust год 2028 и день 28 февраля — мартовские праздники сдвинутся на день позже, чем в 2025-м, и это видно прямо в отсчёте.