# Системные функции: «День недели сегодня (числом) и День недели сегодня (строкой)»

Source: https://docs.botman.pro/a/150-sistemnye-funktsii-den-nedeli-segodnya-chislom-i-den-nedeli-sego

Обе функции возвращают текущий день недели, но в разном виде:

- «День недели сегодня (числом)» — выдаёт число от 1 до 7, где:\
  1 = понедельник, 7 = воскресенье.
- «День недели сегодня (строкой)» — возвращает название дня недели словами:\
  понедельник, вторник, среда и т.д.

💡 Эти функции обновляются автоматически: бот всегда берёт текущую дату и вычисляет день недели в момент выполнения сценария.

---

## **Где можно использовать**

Вы можете вставить эти функции:

- в шаги Сообщение (чтобы бот сам подставлял день недели);
- в условия (например, запустить акцию только в выходные);
- в тексты уведомлений, рассылок или отчётов.

**Как вставить**

Откройте нужный шаг, например Сообщение: В тексте нажмите </> → Системные функции → В списке выберите:

- День недели сегодня (числом) — если нужно использовать число;
- День недели сегодня (строкой) — если хотите вывести текст.

После вставки функция появится в тексте как метка-чип.

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/a5bd7b17bdbb5c6702aa186361e24352254d136d44f10a0d1783d3018a514682.jpg)

---

## Как это работает

| Функция | Пример результата |
| --- | --- |
| `{{day_of_week_number()}}` | 5 |
| `{{day_of_week_string()}}` | пятница |

🔹 Числовая версия — удобна для логики (например, “если число ≥6 → выходной”).\
🔹 Строковая версия — подходит для отображения в сообщениях.

**Примеры использования**

**Приветствие по дню недели**\
«Сегодня `{{day_of_week_string()}}` — отличное время начать новую неделю!»\
Бот сам подставит слово: “Сегодня среда — отличное время начать новую неделю!”

**Акции по дням**\
“Скидка действует только в выходные!”\
Условие: если `{{day_of_week_number()}}` больше или равно 6 → показать сообщение.

Так бот автоматически определит, что сегодня суббота или воскресенье, и покажет нужный сценарий.

**Использование в отчётах**\
“Последняя активность за `{{day_of_week_string()}}` .”→ “Последняя активность за понедельник.”

**Что важно знать**

- Бот определяет день недели по системной дате сервера, учитывая часовой пояс проекта.
- Функции не требуют параметров — просто вставьте их, и бот сам всё посчитает.
- Если вы тестируете сценарий — результат всегда будет текущий день вашего запуска.

**Частые вопросы**

**1. Как бот понимает день недели, если я в другом часовом поясе?**\
Используется часовой пояс, заданный в настройках проекта.

**2. Можно ли показать и число, и название одновременно?**\
Да: “Сегодня {{day\_of\_week\_string()}} ({{day\_of\_week\_number()}} день недели).”\
→ “Сегодня четверг (4 день недели).”