К статье
Практический материал

Другое · 6 мин

Проверка числа в 1С: способы и ограничения

Как в 1С:Предприятии проверить, что значение является числом: встроенные функции, обработка исключений и проверка строк в запросах и отчётах.

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

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

Как 1С определяет числовой тип

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

Для сложных и составных типов сравнение может работать иначе, чем ожидается. Если значение не заполнено или имеет тип «Неопределено», проверка на число вернёт отрицательный результат. Это нормальное поведение, но его нужно учитывать при написании условий.

Проверка типа значения встроенными средствами

Простейший вариант проверки выглядит так: если ТипЗначения(Значение) = Тип(«Число») тогда … . Условие срабатывает только для чисел, созданных напрямую или полученных из реквизитов с числовым типом. Строка, содержащая цифры, таким способом не распознается, потому что её тип остаётся строковым.

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

Порядок действий
  1. 1
    Определите источник значения: реквизит, параметр функции или строка из файла
  2. 2
    Выберите способ проверки: ТипЗначения для типизированных значений или Попытка … Исключение для строк
  3. 3
    Выполните проверку перед использованием значения в формуле
  4. 4
    Зафиксируйте результат и обработайте случай, когда проверка не пройдена

Проверка строки, которая выглядит как число

Часто значение приходит в виде строки, например из текстового файла, обмена данными или пользовательского поля. Функция Число(Строка) пытается преобразовать строку в число, но выдаёт исключение, если преобразование невозможно. Поэтому безопасная проверка заключается в обёртке вызова в конструкцию Попытка … Исключение.

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

Проверка в запросе и отчёте

В языке запросов 1С типизация часто определяется структурой таблицы, а не проверяется явно. Если поле имеет числовой тип в базе, запрос будет работать с ним как с числом. Если же данные приходят из регистра сведений или виртуальной таблицы, тип может быть неочевидным, и стоит проверять результат после получения выборки.

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

Ограничения и риски при автоматической проверке

Автоматическая проверка не заменяет настройку типов реквизитов в конфигурации. Если реквизит задан как строка, но должен содержать число, лучше исправить метаданные, чем постоянно проверять строки в коде. Это снижает вероятность ошибок и упрощает поддержку.

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

Типичные ошибки
01
Проверка строки через ТипЗначения вместо попытки преобразования
02
Преобразование без конструкции Попытка … Исключение
03
Принятие пустой строки или даты за число из-за наличия цифр

Частые ошибки и как их избегать

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

Чтобы избежать ошибок, явно указывайте ожидаемый тип, обрабатывайте исключения и добавляйте отдельную проверку бизнес-правил: неотрицательность, допустимый диапазон, обязательность заполнения. Это делает код предсказуемым и упрощает поиск причины, если данные всё же оказались некорректными.

Контрольные точки

Как проверить результат

Тип значения перед расчётом
Норма

ТипЗначения возвращает Число

Тревожный признак

Тип отличается от Числа или преобразование вызывает исключение

Результат после преобразования строки
Норма

Получено число без исключения

Тревожный признак

Сработал блок Исключение или значение осталось пустым

Как проверить результат и выбрать дальнейшее действие

После проверки важно зафиксировать результат: пройдено или не пройдено. Если проверка не пройдена, решение зависит от контекста. Для документа можно запретить проведение и вывести сообщение пользователю. Для импорта можно записать строку в журнал ошибок и продолжить обработку остальных данных.

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

Итог

Что важно запомнить

Используйте ТипЗначения для типизированных данных и Попытка … Исключение для строк; всегда проверяйте значение перед расчётом.

Часто задаваемые вопросы

Можно ли проверить число без обработки исключений?

Да, если значение уже имеет числовой тип, достаточно сравнить результат ТипЗначения с Тип(«Число»). Для строк исключение обычно неизбежно, потому что функция преобразования сообщает об ошибке только в процессе выполнения.

Что делать, если строка содержит пробелы или запятую?

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

Различается ли проверка в запросе и в коде модуля?

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

Нужно ли менять тип реквизита, если данные приходят строками?

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