Перейти к содержанию

Поле «Целое число»

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

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

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

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

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

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

Поле содержит целое число без дробной части.

Например:

  • 5

  • 120

  • 15000

Если необходимо работать со значениями, содержащими дробную часть, используйте поле «Десятичное число».

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

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

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

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

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

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

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

количество

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

количество

При формировании документа метка будет заменена значением этого поля.

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

сделки.количествоУчеников

Здесь:

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

Если в поле «Количество учеников» сделки указано значение 25, при формировании документа вместо метки будет выведено:

25

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

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

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

  • + — сложение: 10 + 5 → 15;
  • - — вычитание: 10 - 5 → 5;
  • * — умножение: 10 * 5 → 50;
  • / — деление: 10 / 5 → 2;
  • ^ — возведение в степень: 2 ^ 3 → 8.

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

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

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

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

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

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

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

  • целоеСТекстом — позволяет вывести целое число цифрами, прописью и с подходящей формой слова;
  • числоСТекстом — выводит число вместе с согласованным с ним словом в заданном формате.

Особенности

Поле «Целое число» предназначено для значений без дробной части и подходит для математических вычислений.

Если число используется не как количество или расчётное значение, а как код, номер или идентификатор, рекомендуется использовать поле «Текст». Это позволяет сохранить значение в исходном виде, в том числе ведущие нули.