Функции в 1С: что это, типы, примеры и как их использовать

В мире 1С:Предприятие функции играют ключевую роль — они позволяют автоматизировать повторяющиеся операции, структурировать код и создавать гибкие решения для бизнес-задач. Без понимания принципов работы функций невозможно эффективно разрабатывать конфигурации, писать обработки или интегрировать систему с внешними сервисами. Но что такое функция в контексте 1С? Как она отличается от процедуры? И почему опытные разработчики рекомендуют выносить логику в отдельные функции даже для простых задач?

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

Что такое функция в 1С и чем она отличается от процедуры

В 1С:Предприятие 8 функция — это подпрограмма, которая выполняет определенные действия и обязательно возвращает результат с помощью оператора Возврат. В отличие от функции, процедура просто выполняет код, не возвращая никакого значения. Это фундаментальное отличие определяет области применения:

🔄 Функции используют, когда нужно получить расчетное значение (например, сумму налога, остаток на складе или статус документа). Результат можно присвоить переменной или использовать в выражениях.
⚙️ Процедуры применяют для выполнения действий без возврата данных (например, отправка email, печать документа или обновление справочника).

Пример различия на практике:

// Функция: возвращает сумму НДС Функция РассчитатьНДС(Сумма, Ставка) Возврат Сумма * Ставка / 100; КонецФункции // Процедура: выводит сообщение Процедура ПоказатьПредупреждение(Текст) Сообщить(Текст, СтатусСообщения.Важно);

КонецПроцедуры

Важно понимать, что функция всегда должна содержать оператор Возврат, иначе платформа вызовет ошибку. При этом возвращаемое значение может быть любого типа: число, строка, массив, структура или даже другой объект 1С (например, ссылка на документ).

Типы функций в 1С: встроенные и пользовательские

Все функции в 1С:Предприятие делятся на две большие группы:

Встроенные функции — предоставляются платформой и доступны "из коробки". Они покрывают базовые операции: работу со строками (СтрДлина()), датами (ДобавитьМесяц()), массивами (НайтиЗначение()) и другими объектами. Полный список можно найти в синтакс-помощнике (F1 в конфигураторе).
Пользовательские функции — создаются разработчиками для решения специфических задач. Их пишут в модулях объектов, общих модулях или непосредственно в коде обработок/отчетов.

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

Категория	Функция	Пример использования
Работа со строками	`Лев()`	`Лев("1С:Предприятие", 2)` → вернет "1С"
Даты и время	`ТекущаяДата()`	`Если ТекущаяДата() > ДатаОкончания Тогда...`
Математика	`Окр()`	`Окр(10.567, 2)` → 10.57
Типы и значения	`ТипЗнч()`	`Если ТипЗнч(Значение) = Тип("Число") Тогда...`

Пользовательские функции пишут, когда встроенных возможностей недостаточно. Например, для расчета сложной скидки в торговле или проверки уникальности номера документа. Главное правило: не изобретайте велосипед — прежде чем писать свою функцию, проверьте, нет ли аналогичной встроенной или в типовой конфигурации (например, в Бухгалтерии 3.0 или УТ 11).

💡

Чтобы быстро найти встроенную функцию, начните набирать ее название в коде и нажмите Ctrl+Пробел — конфигуратор покажет подсказку с синтаксисом.

Как создать свою функцию: синтаксис и размещение

Синтаксис создания функции в 1С минималистичен, но требует внимания к деталям. Общая структура:

Функция ИмяФункции(Параметр1, Параметр2, ...) // Тело функции Возврат Результат;

КонецФункции

Разберем ключевые элементы:

📌 Имя функции — должно быть осмысленным и отражать суть (например, РассчитатьСтоимостьСНДС(), а не Функция1()). Используйте верблюжий регистр (первая буква маленькая, остальные слова с большой).
🔢 Параметры — перечисляются через запятую. Можно указать значения по умолчанию: Функция Привет(Имя = "Гость").
🔄 Оператор Возврат — обязателен! Без него функция не скомпилируется. Можно возвращать несколько значений через структуру.

Где можно размещать функции:

Модули объектов (справочники, документы, регистры) — функции будут доступны только в контексте этого объекта.
Общие модули — идеально для часто используемых функций (например, расчетов или работы с API). Укажите свойство Глобальный, если функция нужна во всей конфигурации.
Модули обработок/отчетов — для локальных задач, не связанных с основной конфигурацией.

Пример функции в общем модуле для расчета возраста по дате рождения:

Функция ПолныйВозраст(ДатаРождения) Экспорт
Возврат Цел(Год(ТекущаяДата()) - Год(ДатаРождения) -
(Дата(Год(ТекущаяДата()), Месяц(ДатаРождения), День(ДатаРождения)) > ТекущаяДата()));
КонецФункции

Почему в примере используется Цел()

Функция Цел() отбрасывает дробную часть, чтобы возраст был целым числом. Без нее результат мог бы быть 25.999, что неудобно для отчетов.

Практические примеры применения функций

Рассмотрим реальные сценарии, где функции упрощают работу с 1С.

1. Расчеты в торговле

Функция для расчета итоговой суммы с учетом скидки и НДС:

Функция ИтоговаяСумма(БазоваяСумма, ПроцентСкидки = 0, СтавкаНДС = 20)
СуммаСоСкидкой = БазоваяСумма * (1 - ПроцентСкидки / 100);
СуммаНДС = СуммаСоСкидкой * СтавкаНДС / 100;
Возврат СуммаСоСкидкой + СуммаНДС;
КонецФункции

2. Работа со справочниками

Функция для поиска элемента справочника по наименованию (с учетом регистра):

Функция НайтиКонтрагентаПоИмени(Имя, Справочник = Справочники.Контрагенты)
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Ссылка ИЗ " + Справочник.Имя + " ГДЕ Наименование = &Имя";
Запрос.УстановитьПараметр("Имя", Имя);
Результат = Запрос.Выполнить().Выгрузить();
Если Результат.Количество() > 0 Тогда
Возврат Результат[0].Ссылка;
Иначе
Возврат Неопределено;
КонецЕсли;
КонецФункции

3. Обработка документов

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

Функция ДокументПроведен(СсылкаНаДокумент)
Возврат СсылкаНаДокумент.Проведен();
КонецФункции

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

Убедиться, что все параметры имеют значения по умолчанию или передаются при вызове|

Проверить обработку исключений (например, деление на ноль)|

Тестировать функцию на крайних значениях (нулевые суммы, пустые строки)|

Документировать назначение функции в комментариях

-->

Ошибки при работе с функциями и как их избежать

Даже опытные разработчики иногда допускают ошибки, которые ведут к падению производительности или некорректным расчетам. Рассмотрим типичные проблемы:

Рекурсия без условия выхода — функция вызывает саму себя бесконечно, что приводит к переполнению стека. Пример ошибочного кода:
```
Функция Факториал(Число)
Возврат Число * Факториал(Число - 1); // Нет базового случая!
КонецФункции
```
⚠️ Внимание: Всегда проверяйте условие завершения рекурсии. Для факториала нужно добавить Если Число = 1 Тогда Возврат 1;
Чрезмерное использование глобальных функций — когда все функции помещают в общий модуль с свойством Глобальный. Это усложняет поддержку кода и увеличивает время компиляции.
Игнорирование типов параметров — функция ожидает число, а получает строку. Например, РассчитатьНДС("100") вызовет ошибку, если параметр не приведен к числу.

Как минимизировать риски:

🛡️ Добавляйте проверки типов в начало функции:

Если ТипЗнч(Сумма) <> Тип("Число") Тогда
ВызватьИсключение "Параметр 'Сумма' должен быть числом!";
КонецЕсли;

📝 Документируйте назначение параметров и возвращаемое значение в комментариях.
⚡ Тестируйте функции на больших объемах данных — некоторые ошибки проявляются только при работе с тысячами записей.

Критическая ошибка: использование функций в циклах по большим массивам данных (например, по всем строкам документа с 10 000 позиций) может замедлить выполнение в десятки раз. В таких случаях лучше выносить расчеты в запросы или использовать временные таблицы.

Оптимизация функций: советы для повышения производительности

Плохо написанные функции могут стать "узким местом" в конфигурации. Следующие рекомендации помогут ускорить работу:

Кэширование результатов — если функция часто вызывается с одинаковыми параметрами (например, курс валюты на дату), сохраняйте результат в статической переменной:

Функция ПолучитьКурсВалюты(Валюта, Дата)
Статическая Кэш;
Если Кэш = Неопределено Тогда
Кэш = Новый Соответствие;
КонецЕсли;
Ключ = Валюта.УникальныйИдентификатор() + "|" + Дата;
Если НЕ Кэш.СодержитКлюч(Ключ) Тогда
Кэш.Вставить(Ключ, ПолучитьКурсИзБазы(Валюта, Дата));
КонецЕсли;
Возврат Кэш[Ключ];
КонецФункции

Минимизация обращений к базе — вместо множества вызовов ПолучитьОбъект() внутри функции загружайте данные одним запросом.
Использование параметров по умолчанию — это сокращает объем кода при вызове и делает функцию более гибкой.

Пример оптимизированной функции для проверки остатков на складе:

Функция ПроверитьОстатки(Номенклатура, Склад, Количество = 1)
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ СУММА(ОстаткиТоваров.КоличествоОстаток) КАК Остаток
ИЗ РегистрНакопления.ОстаткиТоваров КАК ОстаткиТоваров
ГДЕ ОстаткиТоваров.Номенклатура = &Номенклатура
И ОстаткиТоваров.Склад = &Склад";
Запрос.УстановитьПараметр("Номенклатура", Номенклатура);
Запрос.УстановитьПараметр("Склад", Склад);
Остаток = Запрос.Выполнить().Выгрузить()[0].Остаток;
Возврат Остаток >= Количество;
КонецФункции

Эта функция выполняет всего один запрос к базе, тогда как "наивная" реализация могла бы делать несколько обращений к регистру накопления.

💡

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

Расширенные возможности: функции с неопределенным числом параметров

В 1С есть механизм для создания функций, которые принимают произвольное количество аргументов — это полезно для универсальных обработчиков. Синтаксис:

Функция Суммировать(Параметры)
Результат = 0;
Для Каждого Знч Из Параметры Цикл
Результат = Результат + Знч;
КонецЦикла;
Возврат Результат;
КонецФункции

// Вызов:
Сумма = Суммировать(10, 20, 30, 40); // Вернет 100

Особенности такого подхода:

✅ Гибкость — можно передавать любое количество аргументов.
⚠️ Типизация — все параметры приходят как элементы коллекции, их нужно проверять на тип.
📌 Применение — удобно для логгирования, когда нужно объединить произвольные данные в одну строку.

Пример функции для форматированного вывода сообщений:

Функция Лог(Сообщение, Параметры = Неопределено)
Если Параметры <> Неопределено Тогда
Сообщение = СтроковыеФункции.ПодставитьПараметры(Сообщение, Параметры);
КонецЕсли;
ЗаписьЖурналаРегистрации("Приложение", УровеньЖурнала.Информация, , Сообщение);
КонецФункции

// Использование:
Лог("Обработано документов: %1, ошибок: %2", Новый Массив(100, 0));

Такой подход упрощает отладку и ведение журналов, особенно в сложных интеграционных решениях.

⚠️ Внимание: Функции с неопределенным числом параметров могут усложнить поддержку кода, если их логика становится слишком сложной. Используйте их только когда это действительно оправдано.

FAQ: Ответы на частые вопросы о функциях в 1С

Можно ли в функции использовать другие функции?

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

Как передать в функцию ссылку на документ?

Ссылку на документ (или любой другой объект 1С) можно передавать как параметр функции. Например:

Функция ПолучитьСуммуДокумента(СсылкаНаДокумент)
Док = СсылкаНаДокумент.ПолучитьОбъект();
Возврат Док.ИтоговаяСумма;
КонецФункции

При вызове передавайте ссылку напрямую: ПолучитьСуммуДокумента(Документы.ЗаказПокупателя.НайтиПоНомеру("0001"));

Чем отличается функция от метода?

В 1С метод — это функция или процедура, принадлежащая конкретному объекту (например, метод Провести() у документа). Функция же может быть самостоятельной подпрограммой в модуле. Методы вызываются через точку (Документ.Провести()), а функции — по имени (РассчитатьСумму()).

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

Для возврата нескольких значений используйте структуру:

Функция ПолучитьДанныеОТоваре(Товар)
Результат = Новый Структура;
Результат.Вставить("Цена", Товар.Цена);
Результат.Вставить("Остаток", ПолучитьОстаток(Товар));
Возврат Результат;
КонецФункции

// Пример использования:
Данные = ПолучитьДанныеОТоваре(Товар);
Сообщить("Цена: " + Данные.Цена + ", Остаток: " + Данные.Остаток);

Можно ли вызвать функцию из 1С в внешней системе (например, через HTTP)?

Да, для этого нужно опубликовать функцию как веб-сервис. В общем модуле укажите свойство ВебСервис, а функцию пометьте аннотацией @ВебМетод. Пример:

// В общем модуле с свойством ВебСервис Функция ПолучитьКурсВалюты(КодВалюты, Дата) Экспорт // Логика получения курса Возврат Курс;