Как добавить лидирующие нули в 1С

Лидирующие нули нужны в 1С чаще, чем кажется: при выгрузке ИНН и КПП в отчёты, формировании номеров документов фиксированной длины, обмене с банками и государственными системами, выводе кодов счетов и артикулов. Проблема в том, что числовые значения в 1С не хранят нули слева — число 42 останется 42, как бы вы его ни форматировали на входе. Поэтому дополнение нулями всегда делается либо при преобразовании в строку, либо через настройку длины строкового реквизита.

Есть несколько рабочих способов: функция Формат() с шаблоном, собственная функция дополнения строки слева, форматирование через шаблон номера документа и хранение значения изначально как строки фиксированной длины. Выбор зависит от того, где нули нужны — только на печати и в выгрузке или в самих данных.

Почему 1С теряет нули слева и когда это важно

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

Типичные места, где это критично: ИНН организации (10 знаков) и ИНН физлица (12 знаков), КПП (9 знаков), коды ОКТМО и КБК, номера счетов (20 знаков), номера документов при обмене с ЭДО и банками, артикулы фиксированной длины. Если выгрузить ИНН «123456789» вместо «0123456789», файл может не пройти форматно-логический контроль у приёмной системы.

Способ 1. Функция Формат() с шаблоном

Самый короткий путь — встроенная функция Формат() с параметром «ЧЦ» (число целых знаков) и признаком дополнения нулями. Шаблон "ЧЦ=8; ЧВН=" означает: общая длина целой части 8 символов, недостающие позиции заполнить ведущими нулями.

НомерСтрокой = Формат(НомерДокумента, "ЧЦ=8; ЧВН=");
// НомерДокумента = 123 -> "00000123"

ИННСтрокой = Формат(ИНН, "ЧЦ=10; ЧН=");
// ИНН = 123456789 -> "0123456789"

Обратите внимание на нюансы синтаксиса. Параметр ЧВН (число с ведущими нулями) включает дополнение нулями слева, а ЧН=0 задаёт представление нуля. Если опустить ЧВН, число будет дополнено пробелами слева, а не нулями — это частая причина «не работающего» форматирования.

Способ удобен для разового вывода: в печатных формах, при формировании текстовых файлов выгрузки, в полях отчётов. Ограничение — функция работает с числами, поэтому если исходное значение уже строка (например, ИНН, введённый пользователем как текст), сначала проверьте, что оно состоит только из цифр.

Способ 2. Собственная функция дополнения строки слева

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

Функция ДополнитьСтрокуСлева(Знач Значение, Длина, Символ = "0") Экспорт
	Результат = СокрЛП(Строка(Значение));
	Пока СтрДлина(Результат) < Длина Цикл
		Результат = Символ + Результат;
	КонецЦикла;
	Возврат Результат;
КонецФункции

// Использование:
Артикул = ДополнитьСтрокуСлева("4571", 10); // "0000004571"

Такую функцию обычно размещают в общем модуле с признаком «Сервер» (или «Клиент», если она нужна на клиенте), чтобы вызывать из любого места конфигурации. В типовых конфигурациях часто уже есть аналог — например, функции вида ДополнитьСтроку в общих модулях работы со строками. Перед написанием своей версии проверьте состав общих модулей: дублирование функционала усложняет сопровождение.

Вариант без цикла — через формирование строки нулей и взятие правой части: Прав(\"0000000000\" + СокрЛП(Значение), 10). Он короче и быстрее на больших объёмах, но требует, чтобы заготовленная строка нулей была не короче целевой длины.

Способ 3. Номера документов фиксированной длины

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

В типовых конфигурациях генерация номера с префиксом и нулями выполняется в подписках на событие «ПриУстановкеНовогоНомера» (например, процедуры ПрефиксацияОбъектовСобытия.УстановитьПрефиксИнформационнойБазыИОрганизации). Если вы дорабатываете нумерацию, меняйте именно эти обработчики или добавляйте свою подписку, а не встроенные механизмы платформы.

Способ 4. Хранение значения как строки фиксированной длины

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

Флаг «Фиксированная длина» в свойствах строки заставляет 1С дополнять значение до указанной длины, но дополняет она пробелами справа, а не нулями слева. Поэтому дополнение нулями всё равно выполняют кодом — в обработчике «ПередЗаписью» или при вводе. Зато строковый тип гарантирует, что записанные нули не потеряются при сохранении и обменах.

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

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

FAQ