time

Макрос !{time} предназначен для работы с датами и временем: парсинга, форматирования, вычислений и манипуляций.

Возможности

Получить текущее время

• !{time|value:now}

Отформатировать дату

• !{time|value:now; output_format:DD.MM.YYYY}

Прибавить/вычесть время

• !{time|value:now; plus:3D12h30m}

Округлить время

• !{time|value:now; round:hour}

Сменить часовой пояс

• !{time|value:now; output_timezone:UTC}

Отобразить в Telegram-формате

• !{time|value:now; tg_format:r}

💡 Совет: Макрос можно вставлять в любое место, где поддерживаются переменные: текст сообщения, заголовки HTTP-запросов, тело запроса, настройки отложенных действий.

Синтаксис

!{time|
  параметр1: значение1;
  параметр2: значение2;
}

Правила:

• Макрос начинается с !{time| и заканчивается }
• Параметры разделяются символом ; (точка с запятой)
• Рекомендуется каждый параметр писать с новой строки для удобства чтения

Входные параметры (источник времени)

По умолчанию принимает:

• now — текущее время (в часовом поясе бота)
• RFC3339 формат — например, 2025-11-03T13:02:12+03:00
• Для других форматов необходимо указать input_format или format1
• Для Unix timestamp на входе указать input_format:unix (секунды) или input_format:unixMilli (миллисекунды)

Форматы времени

Параметры форматов

Стандартные форматы (названия)

Специальные значения (для input_format и output_format):

Пользовательский формат (буквенные паттерны)

Экранирование текста (литералы)

Если в формате есть буквенный текст, который совпадает с паттернами (D, M, Y, h, m, s, a, A, z, l, W, N), заключите его в квадратные скобки [текст].

Примеры:

⚠️ Важно: Без скобок D в слове «Сегодня» было бы воспринято как паттерн дня.

Telegram tg-time форматирование

Параметр tg_format оборачивает результат в HTML-сущность <tg-time>. Telegram отображает такие даты в локализованном формате пользователя.

Допустимые значения:

Комбинации: флаги можно комбинировать: wDT, wt, Dt и т.д.

💡 Текст внутри тега (output_format) используется как fallback (если Telegram не может отобразить tg-time).

Манипуляции со временем

Добавление/вычитание длительности

Формат длительности: [число] [единица]

Доступные единицы:

Комбинирование:

* plus:1Y2M3D
* plus:12h30m
* plus:2D12h30m15s

Особенности сдвига месяцев/лет:

При сдвиге на годы или месяцы день прижимается к последнему дню результирующего месяца:

Установка следующего дня недели (next)

Установка компонентов времени

Особенности установки года и месяца:

Если текущий день не помещается в новом месяце/году — прижимается к последнему дню:

Округление

Примеры:

Часовые пояса

Форматы:

Порядок выполнения операций

Операции выполняются строго в следующем порядке:

Примеры

Простые примеры (80% сценариев)

Текущая дата в формате ДД.ММ.ГГГГ

!{time|value:now; output_format:DD.MM.YYYY}

Текущее время ЧЧ:ММ:СС

!{time|value:now; output_format:hh:mm:ss}

Текущая дата и время

!{time|value:now; output_format:YYYY-MM-DD hh:mm:ss}

Завтрашняя дата

!{time|value:now; plus:1D; output_format:DD.MM.YYYY}

Через 1 час 30 минут

!{time|value:now; plus:1h30m; output_format:hh:mm}

Арифметика

Через 3 дня, 12 часов, 30 минут

!{time|value:now; plus:3D12h30m}

Результат: 2026-05-28T03:00:45+03:00

Ровно 1 год назад

!{time|value:now; minus:1Y; output_format:DD.MM.YYYY}

Результат: 25.05.2025

Через 2 года, 3 месяца, 5 дней

!{time|value:now; plus:2Y3M5D; output_format:DD.MM.YYYY}

Результат: 30.08.2028 (с учётом прижатия дня)

Определение конкретной даты

Сегодня в 23:59:59

!{time|value:now; setHour:23; setMinute:59; setSecond:59; output_format:hh:mm:ss}

Результат: 23:59:59

Первый день текущего месяца в 00:00

!{time|value:now; setDay:1; truncate:day; output_format:DD.MM.YYYY hh:mm}

Результат: 01.05.2026 00:00

Ближайший понедельник

!{time|value:now; next:monday; output_format:DD.MM.YYYY}

Результат: 01.06.2026 (если сегодня 25.05.2026)

Unix timestamp

Получить текущий Unix timestamp (секунды)

!{time|value:now; output_format:unix}

Результат: 1748147400

Преобразовать Unix timestamp в дату

!{time| value: 1748147400; input_format: unix; output_format: DD.MM.YYYY hh:mm }

Результат: 25.05.2026 14:30

Telegram tg-time формат

Относительное время (Telegram сам покажет "через 5 минут" и т.д.)

!{time|value:now; plus:10m; tg_format:r}

Результат: через 10 минут

День недели + дата + время

!{time|value:now; plus:3D; tg_format:wDT}

** Результат: чт, 28 мая 2026 г., 14:30

Только дата и время

!{time|value:now; plus:3D; tg_format:dt}

Результат: 28 мая 2026 г., 14:30

Резюме

Текущая дата

!{time|value:now; output_format:DD.MM.YYYY}

Текущее время

!{time|value:now; output_format:hh:mm:ss}

Прибавить N дней

!{time|value:now; plus:ND; ...}

Вычесть N часов

!{time|value:now; minus:Nh; ...}

Unix timestamp → дата

!{time|value:1234567890; input_format:unix; output_format:DD.MM.YYYY}

Telegram-формат

!{time|value:now; tg_format:wDT}

Сменить часовой пояс

!{time|value:now; output_timezone:UTC}

Связанные разделы

Макросы — общая документация по макросам

Переменные — работа с переменными