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

Во встроенном языке 1С нет привычного оператора «^» или «**», как в других языках программирования. Возведение в степень выполняется через встроенную функцию Pow(Основание, Показатель), которая доступна и в тонком клиенте, и на сервере, и в веб-клиенте. Функция принимает два числовых аргумента и возвращает результат типа Число.

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

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

Синтаксис функции Pow и базовые примеры

Функция вызывается глобально, без обращения к какому-либо объекту. Первый параметр — основание степени, второй — показатель. Оба параметра приводятся к числу, поэтому передавать строку «2» технически возможно, но полагаться на неявное приведение не стоит: лучше заранее преобразовать значение через Число().

Результат = Pow(2, 10);        // 1024
Квадрат = Pow(Сумма, 2);       // квадрат числа
Куб = Pow(Сторона, 3);         // объём куба
Степень = Pow(Основание, 0.5); // квадратный корень

Частный, но важный случай — показатель 0.5 даёт квадратный корень, 1/3 — кубический. Отдельной функции извлечения корня произвольной степени в платформе нет, поэтому Pow с дробным показателем — стандартный приём. Для квадратного корня также корректно работает этот вариант, специальной функции Sqrt во встроенном языке нет.

Функция СложныйПроцент(Сумма, Ставка, Периодов)
	Возврат Сумма * Pow(1 + Ставка / 100, Периодов);
КонецФункции

Типичные сценарии использования

Финансовые расчёты

Самая частая прикладная задача — сложные проценты и дисконтирование. Формула наращения Сумма * Pow(1 + Ставка, Периоды) используется в расчётах кредитов, депозитов и приведения будущих платежей к текущей стоимости. Здесь критично следить за тем, чтобы ставка была выражена в долях (0,12), а не в процентах (12), иначе результат будет завышен на порядки.

Статистика и контроль качества

Дисперсия и среднеквадратичное отклонение требуют возведения отклонений в квадрат. В цикле по выборке накапливают сумму квадратов отклонений от среднего, затем делят на количество элементов. Для квадратов вместо Pow часто используют простое перемножение Отклонение * Отклонение — это чуть быстрее и нагляднее.

Геометрические и складские расчёты

Объём по линейным размерам, площадь круга через радиус, пересчёт упаковок — всё это степени 2 и 3. В таких задачах важна разрядность результата: если реквизит документа имеет точность 2 знака после запятой, а расчёт даёт 6 знаков, итог будет молча округлён при записи.

Возведение в степень в запросах

Язык запросов 1С не содержит функции Pow — прямо написать Pow(Поле, 2) в тексте запроса нельзя, запрос не скомпилируется. Это ограничение часто становится неожиданностью при построении отчётов.

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

// СКД: вычисляемое поле с выражением из общего модуля
// В общем модуле (сервер, вызов сервера):
Функция ВозвестиВСтепень(Значение, Показатель) Экспорт
Возврат Pow(Значение, Показатель);
КонецФункции

В выражении вычисляемого поля СКД тогда пишут вызов вида ОбщийМодуль1.ВозвестиВСтепень(Поле, 2). Учтите, что функция будет вызываться для каждой строки результата — на больших выборках это заметно медленнее, чем расчёт во временной таблице.

Отрицательные и дробные показатели: ограничения

Отрицательный показатель работает корректно: Pow(2, -3) вернёт 0,125. Проблемы начинаются с отрицательным основанием и дробным показателем — математически это комплексное число, и платформа в такой ситуации выдаст ошибку или некорректный результат в зависимости от контекста. Перед вызовом проверяйте знак основания, если показатель может быть дробным.

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

Альтернатива: цикл и собственная функция

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

Функция СтепеньЦелая(Основание, Показатель) Экспорт
Результат = 1;
Для Сч = 1 По Показатель Цикл
Результат = Результат * Основание;
КонецЦикла;
Возврат Результат;
КонецФункции

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

Проверка результата и отладка

Быстрее всего проверить вычисление — в конфигураторе через отладку: поставьте точку останова, вызовите окно «Вычислить выражение» (Shift+F9) и выполните Pow(2, 10) прямо в нём. Это удобный способ подобрать параметры формулы до написания кода.

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

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