целоеСТекстом
Функция целоеСТекстом
используется для преобразования целого числа в строку: с числом, его прописью и нужным словом в правильной форме.
Применяется, когда нужно подставить числовое значение вместе с текстом — например, 3 (три) яблока
.
Синтаксис
целоеСТекстом(число,"яблоко","i (ii) W",ТипЧислительного.Количественное,
Падеж.Именительный,".")
-
число
— поле или выражение, содержащее целое число. -
"яблоко"
— текст, который будет склоняться по числу (например, "яблоко", "яблока", "яблок"). -
"i (ii) W"
— формат отображения числа с текстом:-
i
— число цифрами -
ii
— число прописью -
W
— текст
-
-
ТипЧислительного.Количественное
- тип числительного (Количественное или Порядковое). -
Падеж.Именительный
- падеж, в котором будет отображаться число с текстом. -
"."
— разделитель тысяч, который может быть одним из следующих символов: точка (.), запятая (,), двоеточие (:) или пробел ( ). Пример: 1.234.
Принцип работы:
-
Получение числового значения. Функция принимает целое число, которое будет преобразовано в текстовый формат.
-
Определение формы слова. На основе переданного числового значения функция автоматически выбирает правильную форму слова (например, для числа 1 —
яблоко
, для числа 2 —яблока
, для числа 5 —яблок
). -
Формат отображения. Параметр
i (ii) W
указывает, как будет отображаться число с текстом. -
Склонение по падежам. Функция изменяет форму слова в зависимости от падежа, заданного в параметре (например,
Падеж.Именительный
). -
Использование разделителя тысяч. Если число большое, функция применяет разделитель тысяч для улучшения читаемости.
Пример:
Задача: вывести количество документов в формате 3 (три) документа
.
Шаги:
-
Вставьте в шаблон поле типа «Целое число» —
количествоДокументов
. -
Дважды кликните по вставленному полю в шаблоне.
-
Нажмите
f(x)
и выберите Морфологические → целоеСТекстом. -
Заполните параметры:
Результат