Как привести значение к нужному типу в 1С

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

В 1С нет единого универсального оператора приведения, как в некоторых языках. Для разных типов используются разные механизмы: функции-конструкторы Число(), Строка(), Дата(), Булево(), методы XMLЗначение() и ЗначениеИзСтрокиВнутр(), а также объект ОписаниеТипов с методом ПривестиЗначение(). Выбор зависит от того, какой тип нужен на выходе и насколько строго нужно контролировать ошибки.

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

Как привести строку к числу и обратно

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

Значение = Число("123,45");        // 123,45
Попытка
Результат = Число(СтрокаИзФайла);
Исключение
Результат = 0;
// записать в журнал регистрации
КонецПопытки;

Обратная операция — Строка() — работает практически с любым значением и никогда не вызывает исключения. Для ссылочных типов она возвращает представление объекта, поэтому для получения GUID ссылки используется Строка(Ссылка.УникальныйИдентификатор()).

Важный нюанс: Число() при разборе строки учитывает региональные настройки сеанса. Если файл приходит с точкой в качестве разделителя, а сеанс настроен на запятую, лучше предварительно заменить разделитель через СтрЗаменить(), чем ловить ошибки.

Приведение к дате: форматы и подводные камни

Функция Дата() принимает либо компоненты даты (год, месяц, день, и опционально время), либо строку в формате, соответствующем региональным настройкам. Практика показывает, что строковый вариант — источник большинства ошибок, потому что формат «01.02.2026» в разных локалях трактуется по-разному.

Д1 = Дата(2026, 2, 1);              // надёжно: из компонентов
Д2 = Дата("20260201153000");        // строка ГГГГММДДччммсс
Д3 = Дата("01.02.2026 15:30:00");   // зависит от локали сеанса

Наиболее надёжный способ при загрузке из файлов — строковый формат ГГГГММДДччммсс без разделителей: он не зависит от региональных настроек. Если источник отдаёт дату в другом виде, разберите строку вручную через СтрРазделить() и соберите дату из компонентов.

Булево и Неопределено: неочевидные правила

Функция Булево() приводит число по правилу: 0 — Ложь, любое другое число — Истина. Строка преобразуется по региональным представлениям «Истина»/«Ложь», поэтому надёжнее сравнивать строку явно: НРег(СокрЛП(Значение)) = "истина" или проверять на "1"/"0".

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

Если Значение = Неопределено Или Не ЗначениеЗаполнено(Значение) Тогда
Результат = 0;
Иначе
Результат = Число(Значение);
КонецЕсли;

Проверка фактического типа значения выполняется функцией ТипЗнч() в паре с Тип():

Если ТипЗнч(Значение) = Тип("Строка") Тогда
// безопасно работаем как со строкой
КонецЕсли;

Безопасное приведение через ОписаниеТипов

Объект ОписаниеТипов с методом ПривестиЗначение() — основной инструмент, когда нужно привести значение без риска исключения. Если преобразование невозможно, метод возвращает значение по умолчанию для целевого типа (0, пустая строка, пустая дата), а не прерывает выполнение кода.

ОписаниеЧисла = Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(15, 2, ДопустимыйЗнак.Любой));
Результат = ОписаниеЧисла.ПривестиЗначение(СтрокаИзФайла);
// при ошибке вернёт 0, исключения не будет

Дополнительное преимущество — квалификаторы. Описание типов сразу обрежет число до заданной точности, а строку — до указанной длины, что удобно при записи в реквизиты с ограничениями. Также ПривестиЗначение() умеет приводить ссылки: если передать строку, совпадающую с представлением, к составному типу, платформа попытается найти подходящее значение.

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

ОписаниеТипа = Метаданные.Справочники.Номенклатура.Реквизиты.Код.Тип;
БезопасноеЗначение = ОписаниеТипа.ПривестиЗначение(ВходноеЗначение);

Приведение ссылок и работа с XML-типами

Ссылочные типы не приводятся функциями-конструкторами. Чтобы получить ссылку из строкового GUID, используется конструктор через Новый или методы менеджера объекта:

УИД = Новый УникальныйИдентификатор(СтрокаGUID);
Ссылка = Справочники.Номенклатура.ПолучитьСсылку(УИД);

Для обмена через XML, веб-сервисы и форматы типа EnterpriseData применяются функции XMLЗначение() и XMLСтрока(). Они работают с каноническими представлениями: дата в формате ISO 8601, булево как true/false, число с точкой. Это устраняет зависимость от локали, но требует, чтобы входная строка строго соответствовала формату XML Schema.

Д = XMLЗначение(Тип("Дата"), "2026-02-01T15:30:00");
СтрокаДляОбмена = XMLСтрока(ТекущаяДатаСеанса());

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

Проверка результата и типичные ошибки

После приведения результат стоит проверить, особенно если данные пришли извне. Контрольные точки просты: число не должно молча стать нулём, если ноль недопустим по смыслу; дата не должна быть пустой ('00010101'); строка после приведения через квалификаторы не должна обрезаться неожиданно.

Ещё одна частая ситуация — приведение в запросах. В языке запросов есть оператор ВЫРАЗИТЬ(... КАК ...), который приводит тип поля, и функция ЕСТЬNULL() для замены NULL. Помните, что ВЫРАЗИТЬ для чисел и строк работает как ограничение квалификаторов, а не как преобразование произвольной строки в число — нечисловые строки в запросе так не превратить.

Подводя итог: в большинстве прикладных задач достаточно четырёх функций-конструкторов и ОписаниеТипов для безопасных случаев. Главное — не доверять входным данным и проверять результат там, где молчаливое неверное преобразование опаснее явной ошибки.

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