Поле «Десятичное число»

Поле «Десятичное число» используется для хранения числовых значений с дробной частью и выполнения расчётов с ними.

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

Создание и добавление поля

Создание и добавление полей: ИНСТРУКЦИЯ.

Создание и добавление полей: ИНСТРУКЦИЯ

Значение поля

Поле содержит числовое значение, которое может иметь дробную часть.

Например:

• 12,5;
• 1500,75;
• 0,25.

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

Если значение всегда должно быть целым, используйте поле «Целое число».

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

Настройки поля

Для поля «Десятичное число» можно указать количество знаков после запятой.

Эта настройка определяет, сколько знаков после запятой отображается для значения поля.

Общие настройки полей описаны в разделе «Свойства полей».

Вставка поля через вкладку «Метки»

Значение поля можно вставить в шаблон через метку «Значение».

1. Установите курсор в нужное место шаблона.
2. Перейдите на вкладку «Метки» и выберите «Значение».
3. В поле «Выражение» укажите поле, значение которого необходимо вывести.
4. Нажмите «ОК».

Например, если идентификатор поля:

стоимость

в поле «Выражение» укажите:

стоимость

Если поле содержит значение 1250,50, при формировании документа вместо метки будет выведено значение этого поля.

Например, если идентификатор поля:

сделки.стоимость

Здесь:

• сделки — сущность Битрикс24, из которой берутся данные;
• стоимость — поле этой сущности.

Если в поле сделки указано значение 1250,50, при формировании документа вместо метки будет выведено значение этого поля.

В поле «Выражение» можно использовать не только само поле, но и математическое выражение с его значением.

Например, стоимость с учётом количества можно рассчитать непосредственно в выражении.

цена * количество

сделки.цена * сделки.количество

При формировании документа Комбинатор выполнит расчёт и выведет его результат.

Функции и операции для работы с полем

Математические операции

С десятичными числами можно выполнять арифметические действия:

• + — сложение;
• - — вычитание;
• * — умножение;
• / — деление;
• ^ — возведение в степень.

Математические выражения можно использовать:

• в свойстве поля «Формула»;
• в метке «Значение».

Математические функции

Для значений поля можно использовать:

• округлить — округляет число до указанного разряда;
• округлитьвверх — округляет число в сторону большего значения по модулю;
• округлитьвниз — округляет число в сторону меньшего значения по модулю;
• exp — вычисляет экспоненту;
• ln — вычисляет натуральный логарифм;
• log10 — вычисляет десятичный логарифм.

Форматирование числа

• форматЧисла — изменяет формат отображения числового значения;
• форматВалюты — позволяет вывести числовое значение в формате денежной суммы.

Преобразование числа в текст

• числоСТекстом — позволяет вывести числовое значение вместе с согласованным с ним словом в заданном формате.

Особенности

Поле «Десятичное число» следует использовать, если значение может содержать дробную часть или участвовать в расчётах, результат которых может быть дробным.

Если для значения дробная часть не требуется, удобнее использовать поле «Целое число».

Для кодов, номеров и идентификаторов, с которыми не выполняются математические операции, рекомендуется использовать поле «Текст».