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

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

Мы разберём не только техническую сторону, но и типовые ошибки логики, которые приводят к сбоям в отчётах или документах. Например, почему проверка Значение = 0 может дать ложноположительный результат для пустой строки, или как правильно обрабатывать числа в динамических списках с учётом региональных настроек (где разделителем дробной части может быть как точка, так и запятая).

Статья актуальна для платформ 1С:Предприятие 8.3 и 8.2, но с учётом особенностей: некоторые методы (например, Число() с двумя параметрами) появились только в 8.3.6. Если вы работаете со старой версией — обращайте внимание на пометки о совместимости.

1. Базовая проверка: функция ТипЗначения()

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

Если ТипЗначения(Значение) = Тип("Число") Тогда
Сообщить("Это число!");
Иначе
Сообщить("Это НЕ число!");
КонецЕсли;

✅ Плюсы метода:

• 🔹 Мгновенная проверка — не требует преобразований или дополнительных вычислений.
• 🔹 Работает во всех версиях платформы, включая 1С 7.7 (если вдруг поддерживаете устаревшие конфигурации).
• 🔹 Корректно обрабатывает специальные значения: Неопределено, NULL.

❌ Минусы:

• 🚫 Не проверяет строки, которые можно преобразовать в числа (например, "123" вернёт "Строка", хотя по сути это число).
• 🚫 Не учитывает региональные настройки (разделители дробной части).

2. Преобразование строки в число: функция Число()

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

Попытка
ТестЧисло = Число(Значение);
Результат = Истина; // Преобразование прошло успешно
Исключение
Результат = Ложь;  // Значение не является числом
КонецПопытки;

🔹 Особенности работы:

• 📌 В 1С 8.3.6+ функция Число() поддерживает второй параметр — РазделительДробнойЧасти (можно явно указать "," или ".").
• 📌 Если строка содержит лишние символы (например, "100 руб."), преобразование завершится ошибкой.
• 📌 Пустая строка "" вернёт 0, что может быть неожиданным!

⚠️ Внимание: Если вы используете Число() для проверки данных из Excel или CSV, учитывайте, что в этих файлах числа могут быть записаны с экспоненциальной нотацией (например, 1.23E+05 вместо 123000). Функция Число() корректно обрабатывает такой формат.

3. Проверка с учётом региональных настроек

В multinational компаниях или при обмене данными с зарубежными системами разделитель дробной части может отличаться. Например, в России это "," (123,45), а в США — "." (123.45). Чтобы универсально проверять такие числа, используйте комбинацию Заменить() и Число():

Функция ЭтоЧислоСУчётомРегиона(Значение)
Попытка
// Заменяем оба возможных разделителя на точку (стандарт 1С)
Значение = Заменить(Значение, ",", ".");
Значение = Заменить(Значение, " ", ""); // Убираем пробелы (например, "1 000,50")
Число() = Число(Значение);
Возврат Истина;
Исключение
Возврат Ложь;
КонецПопытки;
КонецФункции;

📊 Сравнение разделителей в разных странах:

⚠️ Внимание: Если вы работаете с веб-сервисами или JSON, данные всегда приходят с точкой в качестве разделителя (123.45). В этом случае достаточно использовать Число(Значение) без замен.

4. Регулярные выражения для сложных форматов

Когда числа могут быть записаны в нестандартном формате (например, с валютами, знаками процента или диапазонами как "10-20"), на помощь приходят регулярные выражения. В 1С для этого используется объект РегулярноеВыражение (доступен с версии 8.3.10).

Пример: проверка строки на соответствие формату числа с возможной дробной частью и знаками +/-:

РегВыр = Новый РегулярноеВыражение("^-?\d+[,.]?\d*$");
Если РегВыр.Тест(Значение) Тогда
Сообщить("Строка соответствует формату числа!");
Иначе
Сообщить("Некорректный формат!");
КонецЕсли;

🔍 Расшифровка шаблона:

• 🔢 ^ — начало строки.
• 🔢 -? — необязательный знак минуса.
• 🔢 \d+ — одна или более цифр.
• 🔢 [,.]? — необязательный разделитель (точка или запятая).
• 🔢 \d* — ноль или более цифр после разделителя.
• 🔢 $ — конец строки.

💡 Когда использовать регулярные выражения:

• 📌 Для валидации пользовательского ввода (например, в формах на управляемом интерфейсе).
• 📌 При парсинге неструктурированных данных (например, выделение чисел из текста договоров).
• 📌 Для проверки составных форматов (например, "10 кг" или "50%").

1. Создать объект РегулярноеВыражение с шаблоном

2. Вызвать метод .Тест() для проверки строки

3. Обработать результат (Истина/Ложь)

4. При необходимости извлечь число методом .Найти()

-->

5. Проверка в динамических списках и отчётах

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

Пример для СКД (схема компоновки данных):

1. Добавьте вычисляемое поле с формулой:

   Выражение: ВЫБРАТЬ
   ЕСЛИ ТипЗначения(Поле) = Тип("Число")
   ТОГДА Поле
   ИНАЧЕ 0
   КАК ЧисловоеПоле

2. В настройках поля укажите тип "Число".
3. Используйте это поле для расчётов вместо оригинального.

⚠️ Внимание: В управляемых формах поле ввода с типом "Число" автоматически блокирует ввод нечисловых символов, но это не спасает от:

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

6. Обработка специальных случаев: NULL, Неопределено, пустые строки

В 1С есть несколько "неявных" значений, которые могут сбить проверку:

• 🔹 NULL — появляется при работе с базами данных (например, в запросах).
• 🔹 Неопределено — стандартное значение для неинициализированных переменных.
• 🔹 Пустая строка "" — часто приходит из пользовательского ввода.

📋 Универсальная функция для проверки:

Функция ЭтоДействительноЧисло(Значение)
Если Значение = NULL ИЛИ Значение = Неопределено ИЛИ ТипЗначения(Значение) <> Тип("Число") Тогда
Возврат Ложь;
Иначе
Возврат Истина;
КонецЕсли;
КонецФункции;

🔎 Типовые ошибки:

• 🚨 Сравнение Значение = 0 вернёт Истина для пустой строки "" (потому что 1С неявно преобразует её в 0).
• 🚨 Условие НЕ Значение для NULL вызовет ошибку — сначала проверяйте на NULL!
• 🚨 В запросах используйте ЕСТЬNULL(Поле, 0), чтобы избежать NULL в результатах.

Критическая особенность: В версиях 1С ниже 8.3.10 функция ТипЗначения() для NULL генерирует ошибку. В этом случае используйте конструкцию ЕСЛИ Значение = NULL ТОГДА...

7. Проверка чисел в обменах данными (XML, JSON, EnterpriseData)

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

• 📄 В XML числа часто приходят как строки (<Quantity>100</Quantity>).
• 📄 В JSON числа без дробной части могут сериализоваться как целые (100), а с дробной — как вещественные (100.5).
• 📄 В EnterpriseData (универсальный формат обмена) числа передаются с явным указанием типа.

🛠 Рекомендации по обработке:

1. Всегда десериализуйте данные с явным указанием типа:

   ЧисловоеПоле = Число(ДанныеJSON.Quantity);

2. Для XML используйте ЗначениеИзСтрокиВнутр() с указанием типа:

   ЧисловоеПоле = ЗначениеИзСтрокиВнутр(ЭлементXML.Текст, Новый ОписаниеТипов("Число"));

3. В EnterpriseData проверяйте атрибут xsi:type:

   Если Элемент.Тип = "http://www.w3.org/2001/XMLSchema#decimal" Тогда...

⚠️ Внимание: В обменах с 1С:ERP или 1С:УТ числа могут передаваться с высокой точностью (до 10 знаков после запятой). Убедитесь, что ваша база данных поддерживает такой формат, иначе произойдёт потеря точности при сохранении.

8. Оптимизация производительности при массовой проверке

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

🚀 Способы ускорения:

• 🔥 Используйте массивы и векторные операции (в 8.3.14+ поддерживаются Массив.ВыгрузитьКолонку() и Массив.ЗагрузитьКолонку()).
• 🔥 Для строковых данных применяйте Строка.Разделить() + регулярные выражения одним проходом.
• 🔥 В запросах используйте конструкцию ВЫБРАТЬ ЕСЛИ ТипЗначения(Поле) = Тип("Число") ТОГДА Поле КАК ЧисловоеПоле — это быстрее, чем обработка на клиенте.

📉 Сравнение скорости (тест на 10 000 элементов):

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

FAQ: Частые вопросы по проверке чисел в 1С

РегВыр = Новый РегулярноеВыражение("^\d+$");
Если РегВыр.Тест(Значение) Тогда
// Строка состоит только из цифр
КонецЕсли;

ВЫБРАТЬ
ЕСЛИ ТИПЗНАЧЕНИЯ(Поле) = ТИП("Число")
ТОГДА 1
ИНАЧЕ 0
КАК ЭтоЧисло

Функция ИзвлечьЧислоИзСтроки(Строка)
// Удаляем все символы, кроме цифр, знака минуса и разделителей
Строка = СтрЗаменить(Строка, "[^\d\-,.]", "");
Попытка
Возврат Число(Строка);
Исключение
Возврат Неопределено;
КонецПопытки;
КонецФункции;