Функции этой группы помогают работать с расписанием: проверять рабочее время и находить ближайшие даты событий. Все они учитывают часовой пояс кабинета автоматически.
Где пригодится:
- ответить подписчику, работает ли сейчас поддержка;
- назначить ближайший вебинар, который проходит по четвергам;
- напомнить об оплате, которая списывается 10-го числа;
- поздравить подписчика с днём рождения.
Функции
| Функция | Описание | Пример |
|---|---|---|
| time_interval(начало, конец) | Проверяет, попадает ли текущее время в интервал. Время берётся в часовом поясе кабинета. Можно указывать время ЧЧ:ММ или полные даты. Интервал может переходить через полночь, например time_interval("19:00", "07:00"). Удобно для проверки рабочего времени. | time_interval("10:00", "19:00") → True, если сейчас с 10:00 до 19:00 |
| weekday_date(day, include_today) | Возвращает дату ближайшего дня недели: 1 — понедельник, 7 — воскресенье. Сегодняшний день не учитывается; чтобы учесть его, передайте вторым аргументом True. Формат результата — ГГГГ-ММ-ДД. | Если сегодня пятница, 3 апреля 2026: weekday_date(1) → "2026-04-06" weekday_date(5) → "2026-04-10" weekday_date(5, True) → "2026-04-03" |
| month_date(day, include_today) | Возвращает ближайшую дату с указанным числом месяца (от 1 до 31). Если в месяце нет такого числа, вернётся последний день месяца. Сегодняшняя дата учитывается, только если вторым аргументом передать True. | Если сегодня 3 апреля 2026: month_date(10) → "2026-04-10" month_date(3) → "2026-05-03" month_date(31) → "2026-04-30" |
| birthdate(date) | Возвращает дату ближайшего дня рождения, включая сегодняшний день. Для 29 февраля в невисокосный год вернётся 28 февраля. Дата считается в часовом поясе кабинета, формат результата — ГГГГ-ММ-ДД. | Если сегодня 3 апреля 2026: birthdate("1994-04-28") → "2026-04-28" birthdate("1994-01-10") → "2027-01-10" |
Пример: рабочее время
Проверим, что сейчас будний день с 10:00 до 19:00, и подберём ответ.
client.is_work_time = time_interval("10:00", "19:00") and weekday() <= 5
client.answer_text = if(client.is_work_time, "Оператор ответит в течение 15 минут", "Мы ответим завтра с 10:00")weekday() <= 5 — значит, сегодня понедельник–пятница. Интервал может переходить через полночь: time_interval("19:00", "07:00") вернёт True ночью.
Пример: ближайший вебинар по четвергам
client.webinar_date = weekday_date(4, True) client.webinar_text = "Ждём вас " + date_rus(client.webinar_date) + " в 19:00"
Если сегодня пятница, 3 апреля, в webinar_text запишется Ждём вас 9 апреля в 19:00. Если сегодня четверг, благодаря True вернётся сегодняшняя дата.
Пример: напоминание об оплате 10-го числа
client.pay_date = month_date(10, True) client.pay_text = "Следующее списание — " + date_rus(client.pay_date)
Если в месяце нет нужного числа (например, 31-го), функция вернёт последний день месяца.
Пример: поздравление с днём рождения
client.next_birthday = birthdate(client.birth_date) client.birthday_text = "Ваш день рождения — " + date_rus(client.next_birthday) + ". Подарок уже ждёт!"
Для 29 февраля в невисокосный год функция вернёт 28 февраля.
Остальные операции с датами — в статье Формула: даты и время.
Если вы не нашли ответ на свой вопрос, задайте его нам в чате внутри кабинета либо напишите в Telegram BotHelpSupportBot или на почту hello@bothelp.io
Получите 14 дней полного функционала платформы для создания рассылок, автоворонок и чат-ботов BotHelp.
Зарегистрируйтесь в BotHelp
14 дней полного доступа бесплатно. Хватит, чтобы собрать первого бота и проверить его на реальных подписчиках.
Создать аккаунт