К статье
Практический материал

Другое · 6 мин

Как вывести название дня недели в 1С

Практически о получении названия дня недели в 1С: функции даты, вычисление в запросе, зависимость от языка и проверка результата в конфигурации.

В 1С:Предприятии название дня недели обычно не хранится в справочниках, а вычисляется из даты документа, регистра или периода отчёта. Это нужно для группировки продаж по неделям, расчёта графиков, выделения выходных в формах и формирования текстовых отчётов.

Надёжный способ — определить номер дня недели функцией языка 1С, а затем сопоставить его с нужным названием. Такой подход меньше всего зависит от настройки формата даты в интерфейсе и работает одинаково в форме, модуле менеджера и запросе.

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

Откуда берётся день недели в 1С

Дата в 1С — это объект типа Дата, из которого можно извлечь компоненты: год, месяц, число и день недели. Для получения номера дня недели используется встроенная функция, доступная в модулях объектов, менеджеров и в языке запросов. Результат функции — число, а не строка, поэтому название приходится задавать вручную.

Если конфигурация уже содержит справочник календарей или настройки производственного календаря, в нём могут быть готовые признаки рабочего или выходного дня. Для названия дня недели такой справочник не обязателен, но он полезен, если требуется учитывать праздники и сменные графики.

Получение названия в модуле приложения

В модуле формы или объекта получите дату документа, вызовите функцию определения дня недели и организуйте выбор названия по номеру. Примерно это выглядит как последовательная проверка условий: если номер равен одному значению, выводится «Понедельник», если другому — «Вторник» и так далее.

Для повторного использования целесообразно вынести преобразование в отдельную общую функцию. Тогда одна правка правил нумерации или перевода названий не потребует правки во всех формах и отчётах. Функцию можно вызывать при открытии документа, печати или сохранении данных.

Порядок действий в модуле
  1. 1
    Получите дату из реквизита документа или периода отчёта
  2. 2
    Определите номер дня недели встроенной функцией
  3. 3
    Сопоставьте номер с нужным названием через условие или функцию
  4. 4
    Выведите результат в реквизит, таблицу или сообщение
  5. 5
    Проверьте работу на датах из разных дней недели

Вычисление дня недели в запросе

В языке запросов 1С день недели можно получить в виртуальной таблице или через функцию даты, в зависимости от структуры запроса. Часто удобно добавить вычисляемое поле, которое возвращает номер дня недели для даты регистрации документа. После этого в запросе или в коде после выполнения запроса номер преобразуется в текст.

Если отчёт строится в компоновке данных, можно добавить вычисляемое поле с условием «ВЫБОР КОГДА ... ТОКА ... КОНЕЦ». Это позволяет получить готовое название прямо в настройке отчёта без программирования в модуле. Учитывайте, что сложные вычисления в запросе могут повлиять на производительность при больших объёмах данных.

Зависимость от языка и региона

Если выводить день недели через форматирование даты в интерфейсе, результат может отображаться на языке текущего пользователя. В одной базе разные пользователи увидят разные названия, что недопустимо для единых отчётов и обмена данными. Явное сопоставление номера с константами решает эту проблему.

Также нумерация дней недели может начинаться с понедельника или воскресенья в зависимости от региональных настроек и релиза платформы. Не полагайтесь на память: проверьте, какой день соответствует единице, в вашей конфигурации, и только потом пишите условия.

Типичные ошибки
01
Принять номер дня недели за готовое название и вывести цифру в отчёте
02
Использовать язык интерфейса для фиксированных печатных форм
03
Не проверять нумерацию дней в своём релизе платформы

Проверка результата и частые ошибки

Частая ошибка — считать, что функция сразу возвращает строку «Понедельник». На самом деле возвращается число, и без сопоставления в отчёте появится цифра. Другая ошибка — использование названий из текущего языка интерфейса в печатных формах, которые отправляются клиентам в другом регионе.

Проверяйте преобразование на границах недели: понедельник и воскресенье, а также на датах в начале и конце месяца. Если результат пустой или не совпадает с календарём, причина чаще всего в неправильной нумерации или в пустой исходной дате.

Контрольные точки

Как проверить результат

Выводимое значение для известной даты
Норма

Совпадает с календарём и ожидаемым названием

Тревожный признак

Цифра, пустота или название на чужом языке

Когда самостоятельная правка небезопасна

Если вы меняете типовую конфигурацию, добавление собственных функций и реквизитов может усложнить обновление и привести к конфликтам при поддержке. Перед правкой типового модуля убедитесь, что изменения не затрагивают регистр накопления, документы движения и закрытие периода.

Для критических отчётов, влияющих на расчёт зарплаты, налоги или отгрузки, изменения лучше согласовывать с ответственным за конфигурацию и проверять на копии базы. Неправильное определение выходного или рабочего дня может повлиять на расчёты и сроки.

Альтернативы и готовые инструменты

Некоторые конфигурации имеют встроенные отчёты по дням недели или настройки производственного календаря, где уже есть признаки рабочего времени. Перед программированием проверьте, нет ли готового реквизита или отчёта, который решает задачу без кода.

Если нужно выводить день недели в мобильном приложении или веб-клиенте, поведение форматирования может отличаться от толстого клиента. Явное текстовое сопоставление остаётся наиболее предсказуемым вариантом для всех интерфейсов.

Итог

Что важно запомнить

Получайте номер дня недели из даты, а название задавайте явно через сопоставление, проверяя нумерацию и язык в своей конфигурации.

Нужно ли программировать, если есть стандартный отчёт?

Не всегда. Проверьте встроенные отчёты, настройки календаря и реквизиты документов: возможно, день недели или признак рабочего дня уже доступен без кода. Программирование требуется, когда нужно вывести название в форме, печатной форме или выгрузке, где стандартного поля нет.

Почему функция возвращает число, а не название?

В 1С функции работы с датами обычно возвращают порядковый номер компонента, включая день недели. Преобразование в строку делается разработчиком через условие или константы, чтобы результат не зависел от языковых настроек и был одинаковым для всех пользователей.

Как проверить, какой день соответствует номеру один?

Создайте тестовую дату, день недели которой точно известен, выведите результат функции в сообщение или отчёт и сравните с календарём. Повторите проверку после обновления платформы или конфигурации, так как принятая нумерация может отличаться.

Безопасно ли менять типовую конфигурацию для вывода дня недели?

Самостоятельные изменения типового модуля могут усложнить обновления и привести к ошибкам в расчётах. Для важных процессов вносите правки на копии базы, согласовывайте с администратором конфигурации и предпочтительно используйте расширения или отдельные общие модули вместо правки типового кода.