Функции этой группы работают с датами: прибавляют дни и месяцы, считают разницу, переводят дату в нужный формат и выводят её по-русски.
Где пригодится:
- посчитать возраст подписчика или срок с момента покупки;
- получить дату через N дней — например, окончание пробного периода;
- вывести дату по-русски: «3 апреля 2026, пятница».
Функции
| Функция | Описание | Пример |
|---|---|---|
| get_current_time() | Возвращает текущие дату и время в часовом поясе кабинета. Формат: %Y-%m-%d %H:%M:%S. | globals.now = get_current_time() → "2025-11-11 16:30:00" |
| addYear(date, years) | Добавляет или вычитает годы (с учётом високосных лет). Для вычитания используйте отрицательное число. | addYear("2020-01-01", 3) → "2023-01-01" |
| addMonth(date, months) | Добавляет или вычитает месяцы (учитывает длину месяцев и високосные года). | addMonth("2025-01-10", 2) → "2025-03-10" |
| addDays(date, days) | Добавляет или вычитает дни. Для вычитания передайте отрицательное значение. | addDays("20.08.2019", -99) → "13.05.2019" |
| addHours(date, hours) | Добавляет или вычитает часы. Для вычитания передайте отрицательное значение. | addHours("2026-04-03 10:00:00", 3) → "2026-04-03 13:00:00" |
| addMinutes(date, minutes) | Добавляет или вычитает минуты (для значений типа «Дата и время»). | addMinutes(get_current_time(), 20) → "2025-11-11 16:50:00" |
| addWeeks(date, weeks) | Добавляет или вычитает недели. Для вычитания передайте отрицательное значение. | addWeeks("2026-04-03", 1) → "2026-04-10" |
| format_date(date, "формат") | Преобразует дату к заданному формату. Поддерживаемые форматы: %Y-%m-%d, %d.%m.%Y, %Y-%m-%d %H:%M:%S, %d.%m.%Y %H:%M:%S. | format_date("2025-10-10", "%d.%m.%Y") → "10.10.2025" |
| convert_datetime(date, input_format, output_format) | Переводит дату из одного формата в другой. Форматы задаются обозначениями: %Y — год, %m — месяц, %d — день, %H — часы, %M — минуты, %S — секунды. | convert_datetime("2011/11/03", "%Y/%m/%d", "%d.%m.%Y") → "03.11.2011" |
| date_diff(date1, date2, unit) | Возвращает разницу между двумя датами. Параметр unit принимает значения "days" или "minutes". | date_diff(client.birth_date, get_current_time(), "days") → 9125 |
| date_rus(date, with_year) | Выводит дату по-русски: число и месяц. Чтобы добавить год, передайте вторым аргументом True. Если дату не указать, берётся сегодняшняя дата в часовом поясе кабинета. | date_rus("2026-04-03") → "3 апреля" date_rus("2026-04-03", True) → "3 апреля 2026" |
| weekday(date) | Возвращает номер дня недели от 1 до 7: понедельник — 1, воскресенье — 7. Если дату не указать, используется текущая дата в часовом поясе кабинета. | weekday("2026-04-03") → 5 |
| weekday_name(date) | Возвращает название дня недели по-русски, со строчной буквы. Если дату не указать, берётся сегодняшняя дата в часовом поясе кабинета. | weekday_name("2026-04-03") → "пятница" |
| timestamp(date) | Возвращает Unix-время — число секунд с 1 января 1970 года (UTC). Дата считается в часовом поясе кабинета. Если дату не указать, берётся текущее время. | timestamp("2026-01-01 03:00:00") → 1767225600 (для кабинета с московским временем) |
Что важно знать
- Переменные типа «Дата» и «Дата и время» хранятся во внутреннем формате
ГГГГ-ММ-ДД. Например, ввод11.11.2011хранится как"2011-11-11". - Все операции выполняются в часовом поясе кабинета.
- Умножение или деление дат вызывает ошибку «Ошибка типов».
- В
date_diffиз date2 вычитается date1.
Пример: возраст и прогноз
Посчитаем, сколько подписчику лет, и на основе этого сделаем прогноз. Сначала запросим дату рождения и запишем ответ в переменную с типом «Дата» birth_date.

Далее в шаге «Формула»:
- Через date_diff считаем разницу в днях между birth_date и текущей датой get_current_time.
- Через int убираем дробную часть, чтобы получить полное количество лет.
- Через условие if записываем ответ в переменную forecast.
client.age_years = int(date_diff(client.birth_date, get_current_time(), "days") / 365) client.forecast = if(client.age_years >= 30, "Сейчас время системности и стабильности 👌", "Период экспериментов и роста, пробуй новое 💫")
И выведем ответ подписчику в боте:
Тебе {%age_years%} лет {%forecast%}
Пример: дата по-русски
client.today_text = date_rus(get_current_time(), True) + ", " + weekday_name(get_current_time())
В today_text запишется, например, 3 апреля 2026, пятница.
Пример: окончание пробного периода
client.trial_end = addDays(get_current_time(), 14) client.trial_end_text = date_rus(client.trial_end)
Если сегодня 3 апреля, в trial_end_text запишется 17 апреля.
Рабочее время, ближайшие даты событий и дни рождения — в статье Формула: расписание и напоминания. Готовый шаблон для разбора даты рождения — в статье Формула: готовые шаблоны.
Если вы не нашли ответ на свой вопрос, задайте его нам в чате внутри кабинета либо напишите в Telegram BotHelpSupportBot или на почту hello@bothelp.io
Получите 14 дней полного функционала платформы для создания рассылок, автоворонок и чат-ботов BotHelp.
Зарегистрируйтесь в BotHelp
14 дней полного доступа бесплатно. Хватит, чтобы собрать первого бота и проверить его на реальных подписчиках.
Создать аккаунт