Как преобразовать значение в число в 1С

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

Во встроенном языке 1С для этого есть несколько инструментов: функция Число(), операторы приведения через ОписаниеТипов, а также косвенные методы через обработку строк. Выбор зависит от того, откуда пришли данные, насколько они «грязные» и что должно произойти при невозможности преобразования.

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

Функция Число() — основной способ преобразования

Глобальная функция Число() принимает значение и пытается привести его к числовому типу. Она корректно обрабатывает строки вида "123", "123.45", "-50", а также булевы значения (Истина превращается в 1, Ложь — в 0) и даты (в число секунд, хотя на практике такое преобразование почти не используется осознанно).

Пример простейшего использования:

СтрокаИзФайла = "1250,50";
// Внимание: разделитель должен соответствовать ожиданиям функции
Результат = Число("1250.50"); // 1250.5
ЦелоеЧисло = Число("42");     // 42

Важная особенность: функция Число() ожидает точку в качестве разделителя дробной части. Строка "1250,50" с запятой вызовет ошибку, потому что запятая не распознаётся как разделитель. Это самая частая причина сбоев при загрузке данных из Excel, CSV и текстовых файлов, выгруженных с русскими региональными настройками.

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

Безопасное преобразование через Попытка/Исключение

Стандартный приём в прикладном коде — обернуть вызов Число() в конструкцию Попытка...Исключение и задать значение по умолчанию на случай ошибки. Это особенно актуально при пакетной загрузке: одна «битая» строка не должна обрывать обработку всего файла.

Функция СтрокаВЧисло(Строка, ЗначениеПоУмолчанию = 0)
Результат = ЗначениеПоУмолчанию;
Попытка
Результат = Число(Строка);
Исключение
// Строка не является числом — оставляем значение по умолчанию
КонецПопытки;
Возврат Результат;
КонецФункции

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

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

Попытка
	СуммаДокумента = Число(СтрЗаменить(ИсходнаяСтрока, ",", "."));
Исключение
	СуммаДокумента = 0;
	ЗаписьЖурналаРегистрации("Загрузка", УровеньЖурналаРегистрации.Предупреждение,,, "Не удалось преобразовать: " + ИсходнаяСтрока);
КонецПопытки;

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

Реальные данные редко приходят в чистом виде. Типичные загрязнения: запятая вместо точки, неразрывный пробел как разделитель разрядов ("1 250,50"), символ валюты, буква «О» вместо нуля, пробелы по краям. Перед вызовом Число() строку нужно нормализовать.

Минимальный набор операций очистки выглядит так:

Функция ОчиститьИПреобразовать(ИсходнаяСтрока)
Строка = СокрЛП(ИсходнаяСтрока);
// Неразрывный пробел (код 160) и обычный пробел — разделители разрядов
Строка = СтрЗаменить(Строка, Символ(160), "");
Строка = СтрЗаменить(Строка, " ", "");
// Запятую приводим к точке
Строка = СтрЗаменить(Строка, ",", ".");
Результат = 0;
Попытка
Результат = Число(Строка);
Исключение
Результат = 0;
КонецПопытки;
Возврат Результат;
КонецФункции

Обратите внимание на неразрывный пробел: визуально он неотличим от обычного, поэтому данные, скопированные из Excel или веб-страниц, часто «не преобразуются» без видимой причины. Удаление Символ(160) решает эту проблему. Если в данных встречаются символы валют или единицы измерения, их тоже удаляют через СтрЗаменить до преобразования.

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

Иногда вместо перехвата исключения удобнее заранее проверить, состоит ли строка только из допустимых символов: цифр, одного разделителя и знака минуса в начале. Это полезно, когда нужно различать «не число» и «ноль» — например, при валидации пользовательского ввода в форме.

Простой вариант проверки — перебор символов:

Функция ЭтоЧисло(Строка)
Допустимые = "0123456789.-";
Для Позиция = 1 По СтрДлина(Строка) Цикл
Если СтрНайти(Допустимые, Сред(Строка, Позиция, 1)) = 0 Тогда
Возврат Ложь;
КонецЕсли;
КонецЦикла;
Возврат Истина;
КонецФункции

Такая проверка не гарантирует стопроцентной корректности (строка "1.2.3" пройдёт фильтр, но не преобразуется), поэтому её обычно комбинируют с Попытка/Исключение. В типовых конфигурациях есть готовые функции вида СтроковыеФункцииКлиентСервер.ТолькоЦифрыВСтроке() — если конфигурация на БСП, используйте их вместо собственных велосипедов.

1. 1
   Прочитайте значение ячейки или поля как строку
2. 2
   Удалите неразрывные и обычные пробелы, символы валют
3. 3
   Замените запятую на точку как разделитель дробной части
4. 4
   Преобразуйте через Число() внутри Попытка/Исключение
5. 5
   При ошибке запишите строку в протокол и присвойте значение по умолчанию
6. 6
   Проверьте результат на допустимость (например, сумма не отрицательна)

Преобразование через ОписаниеТипов и другие сценарии

Метод ОписаниеТипов.ПривестиЗначение() — альтернативный способ, который ведёт себя мягче: вместо исключения он часто возвращает значение по умолчанию для типа (для числа — 0), если приведение невозможно. Это удобно, когда нужно привести значение к типу реквизита объекта.

ОписаниеЧисла = Новый ОписаниеТипов("Число", 
Новый КвалификаторыЧисла(15, 2, ДопустимыйЗнак.Любой));
Результат = ОписаниеЧисла.ПривестиЗначение("123,45");

Дополнительный плюс ОписаниеТипов — автоматическое округление до заданной разрядности и отсечение лишних знаков. Это полезно при присвоении значений реквизитам документов: тип реквизита известен, и приведение гарантирует соответствие.

Число в запросе

В языке запросов преобразование выполняется функцией ВЫРАЗИТЬ(Поле КАК ЧИСЛО(15,2)). Она применяется, когда значение хранится в строковом или составном поле, а по нему нужно сортировать, сравнивать или агрегировать. Учтите: приведение в запросе не может обработать некорректные строки — результат для них будет непредсказуем, поэтому данные лучше очищать на этапе записи.

Обратная задача: число в строку

Для обратного преобразования используют Строка(), Формат() или строковое соединение. Функция Формат(Значение, "ЧГ=0") позволяет убрать группировку разрядов, чтобы число выводилось без пробелов — это важно при выгрузке в файлы обмена, где пробелы сломают загрузку на принимающей стороне.

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

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

Отдельный граничный случай — очень большие числа и точность. Числовой тип в 1С имеет ограниченную разрядность (в типовых реквизитах обычно задаётся квалификаторами, например 15 знаков и 2 дробных). При превышении разрядности значение округляется или отсекается без предупреждения, что при финансовых расчётах недопустимо. Контролируйте квалификаторы числа у реквизитов, в которые записывается результат.

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

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