Другое · 5 мин
Как получить число по модулю в 1С: Abs и альтернативы
Как в 1С:Предприятии получить модуль числа: функция Abs в коде и АБС в запросах, примеры, проверка знака, типичные ошибки и альтернативы.
Модуль числа в 1С означает его абсолютное значение: убрать знак «минус», оставив только величину. Это нужно при расчёте отклонений, сверках план-факт, определении размера расхождения без учёта направления и в фильтрах, где важен модуль разницы.
В 1С:Предприятии два контекста: встроенный язык программирования и язык запросов. Имена функций отличаются: в коде используется Abs, в запросах — АБС. Ниже показано, как применить каждую форму, как проверить результат и в каких случаях модуль не подходит.
1. Когда модуль числа нужен в 1С
Модуль применяется, когда направление отклонения не важно, а важна его величина. Типичные случаи: сравнение фактических продаж с планом, вычисление разницы остатков на складе, оценка отклонения сроков поставки, проверка превышения лимитов по модулю.
Если отчёт должен показывать только величину расхождения, Abs позволяет привести отрицательное значение к положительному без изменения абсолютной величины. Положительное число остаётся без изменений, ноль остаётся нулём.
2. Абсолютное значение в коде на встроенном языке
В модулях объектов, форм, отчётов и обработок функция пишется так:
Результат = Abs(ИсходноеЧисло);
Например, Abs(-150) вернёт 150, Abs(150) вернёт 150, Abs(0) вернёт 0. Результат можно записать в переменную, использовать в выражениях или вывести на форму. Аргумент должен быть числовым; передача текста или неопределённого значения может привести к преобразованию типа или ошибке в зависимости от контекста.
Перед использованием Abs убедитесь, что источник содержит число. Если значение может быть не заполнено, проверьте его заранее, иначе в расчётах может появиться неопределённое значение, которое пройдёт через функцию без явной ошибки, но исказит итог.
Убедитесь, что знак действительно не нужен для дальнейшего расчёта
Проверьте, нужна ли отдельная обработка нулевого отклонения
Проверьте заполнение перед вызовом Abs
3. Модуль в языке запросов
В тексте запроса функция пишется заглавными буквами по соглашению языка запросов:
ВЫБРАТЬ АБС(Разность) КАК АбсолютнаяРазность ИЗ Таблица;
АБС можно использовать в вычисляемых полях, условиях отбора и группировках. Если нужно отобрать только строки, где модуль отклонения превышает порог, напишите условие вида АБС(Отклонение) > Порог. Это позволяет не отдельно проверять положительное и отрицательное превышение.
В запросе результат также остаётся неопределённым, если источник неопределён. При соединении таблиц и вычислении полей проверяйте, что участвующие поля заполнены, иначе модуль не «вылечит» отсутствующие данные.
- 1Определите, где нужен модуль: в коде модуля или в тексте запроса
- 2Напишите Abs(Число) для встроенного языка или АБС(Выражение) для запроса
- 3Проверьте тип аргумента и заполнение исходного значения
- 4Сравните результат с ожидаемым неотрицательным числом
4. Проверка знака, ноль и неопределённое значение
Модуль убирает информацию о направлении. Если позже нужно знать, было ли отклонение положительным или отрицательным, Abs не подходит: используйте сравнение с нулём или функцию определения знака, а не только модуль.
Ноль не меняется при взятии модуля. Неопределённое значение остаётся неопределённым, поэтому в отчётах и регистрах пустые ячейки не превратятся в нули автоматически. Это может привести к пропуску строк в итогах, если не обработать отсутствие значения явно.
5. Типы данных, ограничения и типичные ошибки
Abs и АБС предназначены для числовых типов. Даты, строки и справочники не являются допустимыми аргументами без явного преобразования. Точность результата зависит от типа исходного числа; после взятия модуля лишние знаки не добавляются и не исчезают.
Частая ошибка — путаница между модулем числа и остатком от деления. В 1С остаток вычисляется оператором %, а модуль — функцией Abs/АБС. Другая ошибка — применение Abs к неопределённому значению в отчёте, когда кажется, что пустое стало нулем, хотя на самом деле оно осталось пустым.
6. Альтернативы и выбор способа
Если нужно сохранить знак, но инвертировать отрицательные значения, напишите условие: если число меньше нуля, взять его с противоположным знаком, иначе оставить как есть. В запросах это можно реализовать через CASE WHEN, а в коде — через Если ... Тогда.
Для остатка от деления используйте %. Для абсолютной величины — Abs в коде и АБС в запросах. Выбор зависит от места расчёта: логику форм и документов лучше выносить в модули на встроенном языке, а массовую выборку и отчёты — в языки запросов.
Что важно запомнить
Модуль числа в 1С — это Abs в коде и АБС в запросах; результат неотрицательный, ноль не меняется, неопределённое остаётся неопределённым, а направление отклонения модуль не сохраняет.
Чем отличается Abs от остатка от деления?
Abs возвращает абсолютное значение числа без знака, а операция % возвращает остаток от деления одного числа на другое. Это разные математические действия, и замена одного другим меняет смысл расчёта.
Что будет с нулём и отрицательным числом?
Ноль остаётся нулём, отрицательное число становится положительным той же величины, положительное не меняется. Неопределённое значение остаётся неопределённым.
Можно ли использовать Abs в отчёте на СКД?
Да, в настройках вычисляемых полей или в тексте запроса набора данных СКД можно использовать АБС. Проверяйте заполнение исходных полей, иначе пустые значения не превратятся в нули автоматически.
Что делать, если значение неопределённое?
Перед вызовом Abs проверьте, заполнено ли значение, и при необходимости замените неопределённое на ноль или другое допустимое число. Это исключит неожиданные пропуски в итогах и расчётах.