К статье
Практический материал

Другое · 6 мин

Как превратить число в строку в 1C:Enterprise

Как в 1C преобразовать число в строку: функции Строка и Формат, разделители, локаль, типичные ошибки и способы проверки результата.

Преобразование числа в строку в 1C:Enterprise нужно при выводе значений в печатные формы, формировании текстовых файлов для обмена, создании комментариев к документам и склеивании реквизитов в одну строку. Результат зависит не только от выбранной функции, но и от настроек пользователя, языка интерфейса и региональных параметров.

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

Перед преобразованием убедитесь, что исходное значение действительно числового типа. В 1C можно проверить это через ТипЗначения(Значение) и сравнить с типами Число, Дата или Строка. Если значение равно Неопределено, результат преобразования может отличаться от ожидаемого.

Не используйте строковое представление числа для дальнейших вычислений. Числовые операции лучше выполнять с исходным числовым реквизитом, а строку формировать только на этапе вывода или записи в текстовый файл.

Когда требуется превратить число в строку

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

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

Функция Строка и её особенности

Строка(Значение) преобразует число в строку с использованием текущих настроек формата. Это самый быстрый способ, но он даёт минимальный контроль над разделителями и количеством знаков. Результат может содержать пробелы в качестве разделителя тысяч в зависимости от локали.

Пример вызова: Строка(Сумма). Если Сумма равна 1234,56, результат может быть «1 234,56» или «1234,56» в зависимости от параметров пользователя. Это удобно для черновиков, но рискованно для обмена данными.

Сравнение вариантов

Строка(Значение)

Быстро, но мало контроля над разделителями. Подходит для отладки и внутренних отчётов.

Формат(Значение, Маска)

Точное управление представлением. Подходит для печати и обмена, требует корректной маски.

Неявное преобразование при склеивании

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

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

Формат(Значение, СтрокаФормата) позволяет задать количество знаков целой и дробной части, наличие разделителя тысяч, знак числа и другие параметры. Маска задаётся строкой с кодовыми буквами, например управление знаками после запятой и подавлением незначащих нулей.

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

Порядок действий
  1. 1
    Убедитесь, что исходное значение имеет числовой тип
  2. 2
    Выберите способ: Строка для быстрого вывода или Формат для точного представления
  3. 3
    Задайте маску формата, если важны разделители и знаки
  4. 4
    Проверьте результат на компьютере с другой локалью
  5. 5
    Запишите строку только в строковый реквизит, не используйте её для расчётов

Локаль, разделители и перенос данных

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

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

Контрольные точки

Как проверить результат

Тип исходного значения
Норма

Число

Тревожный признак

Строка, Дата или Неопределено

Разделитель дробной части
Норма

Соответствует требуемому формату

Тревожный признак

Точка вместо запятой или наоборот

Количество знаков после запятой
Норма

Не обрезано и не добавлено лишних нулей

Тревожный признак

Потеря точности или лишние знаки

Частые ошибки и проверка результата

Одна из частых ошибок — неявное преобразование при склеивании: «Сумма: » + Сумма. Платформа сама превращает число в строку, но формат может быть непредсказуемым. Другая ошибка — использование строки с пробелами в качестве разделителя тысяч в файле, который потом читается другой программой.

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

Типичные ошибки
01
Запись числового результата в строковый реквизит и последующие расчёты по строке
02
Разделение тысяч пробелом в файле обмена без уточнения с приёмной системой
03
Зависимость от неявного преобразования при конкатенации в печатных формах

Выбор метода и альтернативы

Для внутренних отчётов достаточно Строка, если вид значения не критичен. Для документов, счетов и файлов обмена используйте Формат с явно заданной маской. Если нужно вывести число с валютой или единицами измерения, формируйте строку шаблоном, подставляя отформатированное число.

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

Итог

Что важно запомнить

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

Можно ли использовать Строка для файлов обмена?

Можно, но не всегда безопасно. Результат зависит от региональных настроек, поэтому для обмена лучше явно задать формат через Формат или использовать числа без оформления, а разделители оставить на стороне приёмной системы.

Что делать, если число обрезается после преобразования?

Проверьте длину строкового реквизита и маску формата. Возможно, задано недостаточное количество знаков дробной части или реквизит имеет ограничение по длине. Увеличьте точность в макете или измените тип реквизита, если это допустимо.

Какой разделитель дробной части будет в результате?

Разделитель зависит от языка интерфейса и настроек пользователя: запятая или точка. Для критичных файлов задавайте разделитель явно через маску формата или проверяйте результат на целевом компьютере.

Нужно ли преобразовывать число перед сравнением?

Нет. Сравнивайте числовые значения напрямую. Сравнение строковых представлений чисел может дать неверный результат из-за разделителей, пробелов и разного количества знаков.

Может ли неопределённое значение превратиться в пустую строку?

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