Функции этой группы помогают работать с расписанием: проверять рабочее время и находить ближайшие даты событий. Все они учитывают часовой пояс кабинета автоматически.

Где пригодится:

  • ответить подписчику, работает ли сейчас поддержка;
  • назначить ближайший вебинар, который проходит по четвергам;
  • напомнить об оплате, которая списывается 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.

Получить 14 дней бесплатно

Зарегистрируйтесь в BotHelp

14 дней полного доступа бесплатно. Хватит, чтобы собрать первого бота и проверить его на реальных подписчиках.

Создать аккаунт

Была ли статья полезна?

Наши каналыTelegramMAX
Спасибо за обратную связь!