Преобразование переменной в строку в 1С: от простого к сложному

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

Например, функция Строка() работает универсально, но не всегда дает ожидаемый результат с датами или числами. Метод Формат() позволяет гибко настраивать вывод, но требует знания синтаксиса форматирования. А конкатенация через + вообще может привести к неявным ошибкам, если не учитывать типы данных. В этой статье разберем все актуальные методы преобразования — от базовых до продвинутых, с примерами кода и типичными ошибками.

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

1. Базовый метод: функция Строка()

Самый простой и универсальный способ преобразования — встроенная функция Строка(). Она работает практически с любым типом данных и возвращает строковое представление значения. Синтаксис минималистичен:

Строка(Значение[, РазделительДробнойЧасти[, РазделительГруппРазрядов]])

Где:

• 🔹 Значение — любая переменная или выражение, которое нужно преобразовать;
• 🔹 РазделительДробнойЧасти (необязательно) — символ для отделения дробной части у чисел (по умолчанию — запятая);
• 🔹 РазделительГруппРазрядов (необязательно) — символ для разделения тысяч (по умолчанию — пробел).

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

// Число в строку
Число = 1234.56;
СтрЧисло = Строка(Число); // "1 234,56"

// Дата в строку
ТекущаяДата = ТекущаяДата();
СтрДата = Строка(ТекущаяДата); // "01.01.2026 00:00:00"

// Булево значение
Флаг = Истина;
СтрФлаг = Строка(Флаг); // "Истина"

⚠️ Внимание: Функция Строка() не обрабатывает NULL (или Неопределено в 1С). Если передать такое значение, результат тоже будет Неопределено. Всегда проверяйте переменные на пустоту перед преобразованием!

Преимущества метода:

• 🔹 Простота и лаконичность;
• 🔹 Работает с большинством встроенных типов;
• 🔹 Поддерживает настройку разделителей для чисел.

Недостатки:

• 🔸 Ограниченные возможности форматирования (например, нельзя задать формат даты);
• 🔸 Не обрабатывает NULL и составные типы (массивы, структуры).

2. Гибкое форматирование: метод Формат()

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

Формат(Значение, Шаблон[, РазделительДробнойЧасти[, РазделительГруппРазрядов]])

Где Шаблон — строка, определяющая правила форматирования. Например:

Примеры кода:

// Форматирование числа с двумя знаками после запятой
Цена = 199.9;
СтрЦена = Формат(Цена, "ЧДЦ=2; ЧРД=,"); // "199,90"

// Форматирование даты без времени
ДатаДокумента = ТекущаяДата();
СтрДата = Формат(ДатаДокумента, "ДФ=dd.MM.yyyy"); // "01.01.2026"

// Преобразование строки в верхний регистр
Название = "товар 1";
СтрНазвание = Формат(Название, "СФ=Заглавная"); // "ТОВАР 1"

Где использовать Формат():

• 📌 Вывод данных в печатные формы (например, в актах или счетах);
• 📌 Форматирование чисел для отчетов (валюта, проценты);
• 📌 Приведение дат к единому виду в интерфейсе;
• 📌 Преобразование строк (регистр, обрезка и т.д.).

⚠️ Внимание: Шаблоны форматирования зависят от локализации 1С:Предприятие. Например, в российской версии по умолчанию используется разделитель запятая для дробной части, а в европейской — точка. Учитывайте это при разработке мультиязычных решений!

3. Конкатенация строк: оператор + и функция СокрЛП()

Иногда преобразование переменной в строку происходит "неявно" — при конкатенации (объединении) с другой строкой. В 1С для этого используется оператор +. Если один из операндов — строка, то второй автоматически преобразуется в строковый тип.

Примеры:

Имя = "Иван";
Возраст = 30;
Сообщение = "Клиент: " + Имя + ", возраст: " + Возраст;
// Результат: "Клиент: Иван, возраст: 30"

Опасности этого метода:

• 💥 Если переменная содержит NULL (Неопределено), результат всей конкатенации будет Неопределено;
• 💥 Для чисел и дат используется форматирование по умолчанию, которое может не подходить;
• 💥 При объединении большого количества строк возможны проблемы с производительностью.

Чтобы избежать проблем с NULL, используйте функцию СокрЛП() (сократить левые пробелы) или явную проверку:

// Безопасная конкатенация с проверкой на NULL
Сообщение = "Клиент: " + ?(Имя = Неопределено, "", Имя) +
", возраст: " + ?(Возраст = Неопределено, "", Строка(Возраст));

Когда применять конкатенацию:

• 🔧 Формирование простых сообщений или логов;
• 🔧 Объединение небольшого количества строк;
• 🔧 Быстрое преобразование в строку "на лету".

4. Преобразование составных типов: массивы, структуры, соответствия

Со сложными типами данных — массивами, структурами, соответствиями — стандартные методы вроде Строка() не работают. Например, если попытаться преобразовать массив в строку, получим ошибку:

Массив = Новый Массив;
Массив.Добавить(1);
Массив.Добавить(2);
СтрМассив = Строка(Массив); // ОШИБКА: Недопустимый тип данных!

Чтобы преобразовать такие переменные, нужно:

1. 1️⃣ Вручную обойти элементы и сконкатенировать их;
2. 2️⃣ Использовать рекурсивные функции для вложенных структур;
3. 3️⃣ Применить ЗаписьJSON для сериализации.

Пример ручного преобразования массива:

Функция МассивВСтроку(Массив, Разделитель = ", ")
СтрокаРез = "";
Для Каждого Элемент Из Массив Цикл
Если СтрокаРез <> "" Тогда
СтрокаРез = СтрокаРез + Разделитель;
КонецЕсли;
СтрокаРез = СтрокаРез + Строка(Элемент);
КонецЦикла;
Возврат СтрокаРез;
КонецФункции

// Использование
Массив = Новый Массив;
Массив.Добавить(10);
Массив.Добавить(20);
Сообщение = МассивВСтроку(Массив); // "10, 20"

Для структур и соответствий логика аналогична, но нужно учитывать ключи:

Функция СтруктураВСтроку(Структура, РазделительПар = "; ", РазделительКлючЗначение = "=")
СтрокаРез = "";
Для Каждого Ключ Из Структура Цикл
Если СтрокаРез <> "" Тогда
СтрокаРез = СтрокаРез + РазделительПар;
КонецЕсли;
СтрокаРез = СтрокаРез + Ключ + РазделительКлючЗначение + Строка(Структура[Ключ]);
КонецЦикла;
Возврат СтрокаРез;
КонецФункции

Для сериализации в JSON (актуально для 1С 8.3.10+):

Структура = Новый Структура;
Структура.Вставить("Имя", "Иван");
Структура.Вставить("Возраст", 30);
ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку();
ЗаписьJSON.ЗаписатьJSON(Структура);
СтрJSON = ЗаписьJSON.Закрыть(); // '{"Имя":"Иван","Возраст":30}'

⚠️ Внимание: При ручном обходе составных типов будьте осторожны с рекурсией! Если структура содержит саму себя (циклические ссылки), программа зациклится. В таких случаях используйте ЗаписьJSON с настройкой ЗаписьJSON.ИгнорироватьРекурсию = Истина.

5. Работа с NULL и Неопределено: как избежать ошибок

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

Способы обработки NULL:

• 🛡️ Явная проверка перед преобразованием:

Значение = Неопределено;
СтрЗначение = ?(Значение = Неопределено, "", Строка(Значение));

• 🛡️ Использование функции ЗначениеЗаполнено():

Если ЗначениеЗаполнено(Переменная) Тогда
СтрПеременная = Строка(Переменная);
Иначе
СтрПеременная = "";
КонецЕсли;

• 🛡️ Замена NULL на значение по умолчанию с помощью ЗначениеПоУмолчанию() (для реквизитов объектов):

СтрРеквизит = Строка(Объект.Реквизит.ЗначениеПоУмолчанию(""));

Типичные источники NULL в 1С:

• 🔴 Незаполненные реквизиты объектов;
• 🔴 Результаты запросов, где поле может быть NULL;
• 🔴 Параметры функций, которые не были переданы;
• 🔴 Элементы массивов или структур, которые не инициализированы.

Пример безопасной обработки результата запроса:

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ
Сумма КАК СуммаДокумента
ИЗ
Документ.РеализацияТоваровУслуг
ГДЕ
Номер = &Номер";
Запрос.УстановитьПараметр("Номер", "0001");
Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

Если Выборка.Следующий() Тогда
Сумма = ?(Выборка.СуммаДокумента = Неопределено, 0, Выборка.СуммаДокумента);
Сообщение = "Сумма документа: " + Формат(Сумма, "ЧДЦ=2");
Иначе
Сообщение = "Документ не найден";
КонецЕсли;

6. Продвинутые техники: пользовательские функции и регулярные выражения

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

Функция УниверсальнаяСтрока(Значение, Шаблон = "", ЗначениеПоУмолчанию = "")
Если Значение = Неопределено Тогда
Возврат ЗначениеПоУмолчанию;
КонецЕсли;

Если Шаблон <> "" Тогда
Возврат Формат(Значение, Шаблон);
Иначе
Возврат Строка(Значение);
КонецЕсли;
КонецФункции

// Примеры использования
Сообщение1 = УниверсальнаяСтрока(Неопределено, "", "Нет данных"); // "Нет данных"
Сообщение2 = УниверсальнаяСтрока(1234.56, "ЧДЦ=2"); // "1234,56"
Сообщение3 = УниверсальнаяСтрока(ТекущаяДата()); // "01.01.2026 00:00:00"

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

Телефон = "89123456789";
СтрТелефон = Строка(Телефон);
СтрТелефон = СтрЗаменить(СтрТелефон, "(\d{1})(\d{3})(\d{3})(\d{2})(\d{2})", "+7 ($2) $3-$4-$5");
// Результат: "+7 (912) 345-67-89"

Другие сценарии для продвинутых техник:

• 🎯 Преобразование XML или JSON в читабельную строку;
• 🎯 Форматирование сложных числовых выражений (например, денежных сумм с валютами);
• 🎯 Обработка строк с escape-символами;
• 🎯 Сериализация объектов в строку для логов.

Важно: при использовании регулярных выражений в 1С учитывайте, что их синтаксис отличается от стандартного PCRE. Например, для поиска по шаблону используется функция СтрНайтиПоРегВыражению(), а для замены — СтрЗаменитьПоРегВыражению().

7. Оптимизация производительности: что быстрее?

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

Результаты тестирования (на 100 000 итераций в 1С 8.3.20):

Рекомендации по оптимизации:

• ⚡ Для простых преобразований используйте Строка();
• ⚡ Если нужно форматирование, но производительность критична — кэшируйте шаблоны Формат();
• ⚡ Избегайте конкатенации в циклах (лучше использовать СтрСоединить());
• ⚡ Для составных типов (массивы, структуры) предварительно оценивайте объем данных.

Пример оптимизированного кода для массового преобразования:

// Быстрое преобразование массива чисел в строки
МассивЧисел = Новый Массив;
Для Сч = 1 По 10000 Цикл
МассивЧисел.Добавить(Сч * 1.23);
КонецЦикла;

// Медленный вариант (конкатенация в цикле)
Начало = ТекущаяДата();
СтрокаРез = "";
Для Каждого Число Из МассивЧисел Цикл
СтрокаРез = СтрокаРез + Строка(Число) + ";";
КонецЦикла;
КонецПроцедуры(ТекущаяДата() - Начало); // ~500 мс

// Быстрый вариант (СтрСоединить)
Начало = ТекущаяДата();
МассивСтрок = Новый Массив;
Для Каждого Число Из МассивЧисел Цикл
МассивСтрок.Добавить(Строка(Число));
КонецЦикла;
СтрокаРез = СтрСоединить(МассивСтрок, ";");
КонецПроцедуры(ТекущаяДата() - Начало); // ~120 мс

FAQ: Частые вопросы по преобразованию переменных в строку

Дата = ТекущаяДата();
СтрДата = Формат(Дата, "ДФ=dd.MM.yyyy"); // "01.01.2026"

СтрДата = Лев(Строка(Дата), 10); // "01.01.2026"

Результат = ?(Переменная1 = Неопределено, "", Строка(Переменная1)) +
?(Переменная2 = Неопределено, "", Строка(Переменная2));

Массив = Новый Массив;
Массив.Добавить("Яблоко");
Массив.Добавить("Банан");
СтрМассив = СтрСоединить(Массив, ", "); // "Яблоко, Банан"

Док = Документы.РеализацияТоваровУслуг.НайтиПоНомеру("0001");
СтрСсылка = Строка(Док.Ссылка); // "Документ.РеализацияТоваровУслуг.000000001"

Номер = 123;
СтрНомер = Формат(Номер, "ЧЦ=5; ЧГ=0"); // "00123"

СтрНомер = Лев("00000" + Строка(Номер), 5); // "00123"