Конструктор форматной строки в 1С: полное руководство для разработчиков и пользователей

• 💻 При использовании функции Формат() в коде — конструктор можно вызвать через контекстное меню в синтакс-помощнике.

Чтобы открыть конструктор, обычно достаточно:

1. Выделить поле, для которого нужно настроить формат (например, в макете печати).
2. В свойствах поля найти параметр Формат.
3. Нажать на кнопку с многоточием (...) рядом с полем ввода — откроется окно конструктора.

В некоторых версиях платформы (например, в 1С:Предприятие 8.3.20+) конструктор может выглядеть немного иначе, но принципы работы остаются теми же. Если вы не видите ожидаемых опций, обновите конфигурацию или проверьте настройки интерфейса.

Синтаксис форматных строк: основные элементы

Прежде чем пользоваться конструктором, полезно понимать базовый синтаксис форматных строк. Он состоит из директив — команд, которые указывают, как преобразовать данные. Директивы разделяются точкой с запятой (;). Например:

ЧГ=0; ЧДЦ=2; ЧРД= ; НЧ=0

Разберём этот пример:

• ЧГ=0 — не группировать цифры (отключает разделители тысяч).
• ЧДЦ=2 — выводить ровно 2 знака после запятой.
• ЧРД= — использовать пробел в качестве разделителя разрядов.
• НЧ=0 — заменять Null (пустое значение) на 0.

Конструктор форматной строки позволяет собирать такие шаблоны визуально, без ручного ввода. Однако знание синтаксиса помогает быстрее ориентироваться в настройках и исправлять ошибки.

Тип данных	Пример директивы	Результат	Описание
Число	ЧЦ=10; ЧДЦ=2; ЧРД=;	1 234,56	10 знаков всего, 2 после запятой, разделитель разрядов — точка с запятой
Дата	ДФ=dd MMMM yyyy; ДЛП=Длинный	31 декабря 2026	Полное название месяца, формат дня и года
Строка	СЧ=20; СЗ=пробел	Текст из 20 сим...	Обрезать строку до 20 символов, заполнять пробелами
Булево	БИ=Да; Ложь=Нет; НБ=Не указано	Да / Нет	Замена стандартных Истина/Ложь на пользовательские значения

Важно: директивы чувствительны к регистру! Например, ЧЦ (число цифр) и чц — это разные команды, и вторая не сработает.

Пошаговая инструкция: как пользоваться конструктором

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

1. Откройте макет печати:

   В конфигураторе перейдите в раздел Объекты → [ВашДокумент] → Макеты и выберите нужный макет (например, ПечатнаяФорма).

2. Выделите поле с числом:

   Найдите на макете поле, которое выводит сумму (например, СуммаДокумента), и кликните по нему.

3. Откройте свойства поля:

   В панели свойств найдите параметр Формат и нажмите на кнопку ... рядом с ним.

4. Настройте формат в конструкторе:

   В открывшемся окне:

   • 📌 Выберите тип данных — Число.
   • 📌 Укажите количество знаков после запятой — 2.
   • 📌 Включите разделители разрядов и выберите символ (обычно пробел или запятая).
   • 📌 При необходимости настройте вывод нулевых значений (например, замените 0 на прочерк).
• Проверьте результат:

  Нажмите ОК и сохраните макет. Запустите печать документа, чтобы увидеть, как применяется формат.

Выбран правильный тип данных (число/дата/строка)

Указано нужное количество знаков после запятой

Настроены разделители разрядов (если требуется)

Проверено отображение пустых значений (Null)

Тестировался вывод на реальных данных-->

Если результат не устраивает, вернитесь в конструктор и скорректируйте настройки. Например, для валютных сумм может потребоваться добавить символ валюты (ЧС=руб.).

Типичные ошибки и как их избежать

Даже с конструктором пользователи часто сталкиваются с проблемами при работе с форматными строками. Вот наиболее распространённые ошибки и способы их решения:

• ❌ Неверный тип данных:

  Если вы применяете формат для даты к числовому полю, 1С проигнорирует настройки или выдаст ошибку. Всегда проверяйте, что тип формата соответствует типу данных поля.

• ❌ Конфликт директив:

  Например, одновременно указаны ЧГ=0 (отключить группировку) и ЧРД=; (разделитель — точка с запятой). В этом случае приоритет будет у последней директивы.

• ❌ Неучтённые региональные настройки:

  Формат даты dd.MM.yyyy может не сработать, если в системе установлен другой региональный стандарт (например, MM/dd/yyyy). Используйте универсальные форматы или настройте региональные параметры в 1С.

• ❌ Игнорирование пустых значений:

  Если не указать директиву НЧ (замена Null), пустые поля могут отображаться как # или вовсе пропадать из вывода.

⚠️ Внимание: В версиях 1С:Предприятие 8.3.18 и ниже некоторые директивы (например, ДЛП для длинного формата даты) могут работать некорректно. Проверяйте совместимость в документации к вашей версии платформы.

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

• 💵 Отрицательными числами (-1000.50).
• 💵 Нулевыми значениями (0).
• 💵 Очень большими числами (1 000 000 000).
• 💵 Пустыми значениями (Null).

Практическое применение: примеры форматных строк

Рассмотрим несколько реальных примеров, где конструктор форматной строки значительно упрощает работу.

1. Форматирование денежных сумм

Задача: вывести сумму в формате 1 234,56 руб. с разделителями разрядов и символом валюты.

Решение в конструкторе:

• Тип данных: Число.
• Число десятичных знаков: 2.
• Разделитель разрядов: Пробел.
• Символ валюты: руб. (в директиве ЧС=руб.).
• Замена пустых значений: 0.

Результирующая строка: ЧДЦ=2; ЧРД= ; ЧС=руб.; НЧ=0

2. Вывод даты в длинном формате

Задача: отобразить дату как 31 декабря 2026 года.

Решение:

• Тип данных: Дата.
• Формат даты: dd MMMM yyyy 'года'.
• Локализация: Длинный (для полного названия месяца).

Результирующая строка: ДФ="dd MMMM yyyy 'года'"; ДЛП=Длинный

3. Условное форматирование строк

Задача: если строка пустая, выводить — (прочерк), иначе обрезать до 30 символов.

Решение:

• Тип данных: Строка.
• Максимальная длина: 30.
• Замена пустых значений: —.

Результирующая строка: СЧ=30; НС=—

Эти примеры показывают, как гибко можно настраивать вывод данных. Конструктор позволяет собирать такие строки интуитивно, без знания всех директив наизусть.

Расширенные возможности: условное форматирование и функции

Помимо базовых настроек, конструктор форматной строки поддерживает более сложные сценарии:

• 🎨 Условное форматирование:

  Можно задавать разные форматы в зависимости от значения. Например, отрицательные суммы выводить красным цветом, а положительные — зелёным. Для этого используются директивы вида ЧЦ=2; ЧЦ<0="[Красный]ЧЦ=2".

• 🔄 Преобразование типов:

  С помощью форматной строки можно не только менять внешний вид, но и преобразовывать данные. Например, число 1 выводить как "Да", а 0 — как "Нет" (директива БИ=Да; Ложь=Нет).

• 📊 Работа с коллекциями:

  Для массивов или табличных частей можно настраивать формат вывода каждого элемента, например, разделяя их запятыми: СП=;.

Пример условного форматирования для температуры:

ЧЦ=1; ЧЦ>30="[Красный]ЧЦ=1°С"; ЧЦ<10="[Синий]ЧЦ=1°С"

В этом случае:

• Температура выше 30°С будет красного цвета.
• Ниже 10°С — синего.
• Остальные значения — стандартного цвета.

⚠️ Внимание: Условное форматирование в форматных строках поддерживается не во всех версиях 1С. В старых релизах (до 8.3.15) для этого может потребоваться использовать программный код.

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

FAQ: ответы на частые вопросы

Если СуммаДокумента < 0 Тогда
ТекстСуммы = Формат(Абс(СуммаДокумента), "ЧДЦ=2; ЧРД= ") + " (долг)";
Иначе
ТекстСуммы = Формат(СуммаДокумента, "ЧДЦ=2; ЧРД= ");
КонецЕсли;