Функции этой группы работают с датами: прибавляют дни и месяцы, считают разницу, переводят дату в нужный формат и выводят её по-русски.

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

  • посчитать возраст подписчика или срок с момента покупки;
  • получить дату через 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.

Далее в шаге «Формула»:

  1. Через date_diff считаем разницу в днях между birth_date и текущей датой get_current_time.
  2. Через int убираем дробную часть, чтобы получить полное количество лет.
  3. Через условие 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.

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

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

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

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

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

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