Как преобразовать число в строку в 1С: все способы через запрос и встроенные функции

В работе с 1С:Предприятие часто возникает задача преобразовать числовое значение в строковый формат — будь то для вывода в отчёт, формирования SQL-запроса или обработки данных. На первый взгляд задача кажется тривиальной, но в 1С есть нюансы: разные типы чисел (Число, ДробноеЧисло), локальные настройки формата (разделители тысяч и дробной части), а также особенности работы в контексте запросов 1С и встроенного языка.

Эта статья покрывает все актуальные способы преобразования чисел в строки, включая редко документированные приёмы для запросов, сравнение производительности методов и типовые ошибки. Мы разберём не только стандартные функции вроде Строка() или Формат(), но и малоизвестные трюки — например, как обойти ограничения запросов при работе с числовыми полями или как корректно обработать NULL в результатах выборки.

1. Базовые функции 1С для преобразования числа в строку

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

Самые распространённые функции:

• 🔹 Строка(Число) — универсальный метод, преобразует число в строку с учётом региональных настроек (точка или запятая как разделитель дробной части). Пример: Строка(1234.56) вернёт "1234,56" для русской локали.
• 🔹 Формат(Число, "ФорматнаяСтрока") — гибкий инструмент для кастомизации вывода. Например, Формат(1234.56, "ЧДЦ=0; ЧГ= ") уберёт разделители тысяч и отобразит "1234,56".
• 🔹 СтрЗнач(Число) — аналогичен Строка(), но предназначен для работы с значениями любого типа (включая даты, булевы значения). Полезен в универсальных обработках.
• 🔹 ЧислоПрописью(Число) — преобразует число в текстовое описание (например, 123 → "сто двадцать три"). Актуально для печатных форм документов.

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

2. Преобразование числа в строку непосредственно в запросе 1С

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

2.1. Метод ПРЕДСТАВЛЕНИЕ (для полей выборки)

Самый простой способ — использовать ключевое слово ПРЕДСТАВЛЕНИЕ в секции ВЫБРАТЬ. Оно автоматически преобразует числовое поле в строку согласно региональным настройкам:

ВЫБРАТЬ
СуммаДокумента КАК Число,
ПРЕДСТАВЛЕНИЕ(СуммаДокумента) КАК Строка
ИЗ
Документ.РеализацияТоваровУслуг

Ограничение: ПРЕДСТАВЛЕНИЕ работает только для полей, которые уже есть в таблице источника. Если нужно преобразовать результат выражения (например, СуммаДокумента * 1.2), этот метод не подойдёт.

2.2. Функция СТРОКА в языке запросов (начиная с версии 8.3.10)

В современных версиях платформы (начиная с 8.3.10) в запросах появилась функция СТРОКА(Выражение), аналогичная встроенному языку:

ВЫБРАТЬ
СТРОКА(СуммаДокумента * 1.2) КАК СтрокаСНДС
ИЗ
Документ.РеализацияТоваровУслуг

Это самый надёжный способ для новых конфигураций. Однако в устаревших версиях платформы (например, 8.2 или ранних 8.3) этой функции нет — придётся использовать обходные пути.

2.3. Обходной путь: виртуальная таблица Значение

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

ВЫБРАТЬ
Значение.Значение КАК Строка
ИЗ
Значение(1234.56) КАК Значение

Этот метод универсален, но менее производителен, чем СТРОКА(). Используйте его только при необходимости.

3. Особенности форматирования чисел при преобразовании

Простого преобразования числа в строку часто недостаточно — требуется контроль над форматом: количество знаков после запятой, разделители тысяч, замена точки на запятую и т.д. В 1С за это отвечает функция Формат(), но её синтаксис неочевиден для новичков.

Основные параметры форматирования:

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

Сообщить(Формат(1234567.8912, "ЧДЦ=2; ЧГ= ; ЧРД=.; Л=0"));
// Вернёт: "1234567.89"

Указать количество знаков после запятой (ЧДЦ)|Проверить разделитель тысяч (ЧГ)|Установить нужный разделитель дробной части (ЧРД)|Учесть локальные настройки (Л)|Тестировать вывод на разных данных-->

4. Работа с NULL и пустыми значениями

Одна из распространённых ошибок при преобразовании чисел в строки — игнорирование NULL-значений в результатах запросов. Если поле в базе может быть не заполнено, прямая конвертация приведёт к ошибке. Например, такой запрос упадёт, если СуммаДокумента содержит NULL:

ВЫБРАТЬ
СТРОКА(СуммаДокумента) КАК Строка  // Ошибка, если СуммаДокумента = NULL

Решения:

• 🛡️ Использовать ВЫРАЗИТЬ для приведения к числу с заменой NULL:

ВЫБРАТЬ
СТРОКА(ВЫРАЗИТЬ(СуммаДокумента КАК ЧИСЛО(15, 2))) КАК Строка

• 🛡️ Применять ЗНАЧЕНИЕ с проверкой:

ВЫБРАТЬ
ЕСТЬNULL(СТРОКА(СуммаДокумента), "") КАК Строка

5. Производительность: что быстрее?

Выбор метода преобразования влияет на скорость выполнения кода, особенно в крупных выборках. Мы протестировали производительность разных подходов на базе с 10 000 документов:

Вывод: для запросов предпочтителен СТРОКА(), а для обработки на стороне встроенного языка — Формат(). Виртуальную таблицу Значение используйте только как последний вариант.

6. Типовые ошибки и как их избежать

Даже опытные разработчики 1С иногда сталкиваются с неожиданными проблемами при преобразовании чисел. Вот наиболее частые ошибки и способы их решения:

⚠️ Внимание: При использовании Формат() с параметром Л=1 (локализованный формат) результат зависит от настроек пользователя в системе. Если скрипт должен работать одинаково у всех пользователей, явное указание разделителей (ЧРД=.) надёжнее.

Список распространённых проблем:

• 🐞 Округление дробной части: По умолчанию Строка(1.999) вернёт "2" из-за автоматического округления. Чтобы сохранить точность, используйте Формат(1.999, "ЧДЦ=3").
• 🐞 Потеря разделителей тысяч: Если нужно сохранить разделители (например, "1 000"), укажите ЧГ= в Формат(). По умолчанию они могут пропадать.
• 🐞 Ошибка при NULL: Как упоминалось ранее, всегда обрабатывайте NULL через ВЫРАЗИТЬ или ЕСТЬNULL.
• 🐞 Несовпадение разделителей в SQL-запросах: Если строка с числом потом используется в SQL-выражении (например, в WHERE), замените запятую на точку: СтрЗаменить(Формат(Число), ",", ".").

Пример корректной обработки числа для SQL:

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

// Для SQL-запроса заменяем запятую на точку
СтрокаДляSQL = СтрЗаменить(Результат.СтрокаСумма, ",", ".");

7. Практический пример: преобразование в отчёте

Рассмотрим реальный кейс: нужно вывести в отчёт сумму документа прописью, а также её числовое значение в отформатированном виде. Вот как это сделать:

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

Запрос.УстановитьПараметр("Ссылка", СсылкаНаДокумент);
Результат = Запрос.Выполнить();

Если НЕ Результат.Пустой() Тогда
Данные = Результат.Выгрузить();

// Форматируем строку с разделителями
СтрокаСумма = Формат(Данные[0].Число, "ЧДЦ=2; ЧГ= ; Л=1");

// Преобразуем в пропись
СуммаПрописью = ЧислоПрописью(Данные[0].Число, Ложь);

Сообщить("Сумма: " + СтрокаСумма + " (" + СуммаПрописью + ")");
КонецЕсли;
КонецПроцедуры

Обратите внимание на комбинацию методов:

1. В запросе получаем строку через СТРОКА() (для совместимости).
2. Во встроенном языке доформатировываем строку с нужными разделителями.
3. Отдельно преобразуем число прописью для печатной формы.

FAQ: Частые вопросы

Сообщить(Формат(123, "ЧВН=6")); // Вернёт "000123"

Сообщить(Формат(1000.5, "ЧРД=.")); // Вернёт "1000.5"

СтрЗаменить(СТРОКА(1000.5), ",", ".")

МассивЧисел = Новый Массив;
МассивЧисел.Добавить(10);
МассивЧисел.Добавить(20.5);

МассивСтрок = Новый Массив;
Для Каждого Число Из МассивЧисел Цикл
МассивСтрок.Добавить(Формат(Число, "ЧДЦ=2"));
КонецЦикла;