Как написать функцию в 1С: пошаговая инструкция для новичков

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

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

Функция vs процедура: в чём разница и когда что использовать

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

🔄 Процедуры используют для выполнения действий: изменение данных, вывод сообщений, манипуляции с формами. Например, процедура ЗаполнитьТаблицуТоваров() может загрузить данные в табличный документ, но не вернёт никакого значения.
📊 Функции нужны для вычислений или получения данных. Например, функция РассчитатьСкидку(СуммаЗаказа) вернёт процент скидки, который потом можно использовать в других частях программы.

На практике выбор между ними часто зависит от контекста. Если ваш код должен что-то сделать (например, отправить письмо или обновить запись в базе), это процедура. Если код должен что-то вернуть (например, список клиентов или итоговую сумму), это функция. При этом одна процедура может вызывать десятки функций — и это нормальная практика.

Ещё один нюанс: функции можно использовать прямо в выражениях. Например, вместо того чтобы писать:

Если НДСВключен Тогда СуммаСНДС = Сумма * 1.2 Иначе СуммаСНДС = Сумма

КонецЕсли;

можно создать функцию ДобавитьНДС(Сумма, НДСВключен) и использовать её так:

СуммаСНДС = ДобавитьНДС(Сумма, Истина);

Это делает код лаконичнее и уменьшает риск ошибок при копировании логики.

Синтаксис функции в 1С: разбираем конструкцию по частям

Общий синтаксис функции в 1С 8.3 выглядит так:

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

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

Разберём каждый элемент подробно:

🏷️ ИмяФункции — должно быть уникальным в пределах модуля и отражать суть действия. Используйте верблюжью нотацию (например, РассчитатьИтоговуюСумму), избегайте транслита и сокращений вроде CalcSum().
📝 Параметры — перечислены через запятую. Для каждого параметра можно указать тип (например, Число, Строка), но это необязательно. Если тип не указан, 1С определит его автоматически при первом вызове.
🔄 Экспорт — ключевое слово, которое делает функцию доступной за пределами текущего модуля. Без него функция будет видна только внутри того же модуля.
📤 Возврат — оператор, который определяет, какое значение вернёт функция. Без него компилятор выдаст ошибку.

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

Функция Сложить(Число1, Число2) Возврат Число1 + Число2;

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

💡

Если функция должна вернуть несколько значений (например, сумму и количество элементов), используйте Структура или Массив. Пример: Возврат Новый Структура("Сумма,Количество", Итог, Колво);

Обратите внимание на точку с запятой после Возврат — это обязательный элемент синтаксиса. Без неё код не скомпилируется. Также помните, что имя функции не должно совпадать с зарезервированными словами (Если, Для, Новый и т.д.) или именами встроенных функций (СтрДлина(), ТипЗнч()).

Где размещать функции: модули и область видимости

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

Тип модуля	Область видимости	Пример использования
Модуль формы	Только для текущей формы	Функции для обработки событий элементов формы (например, расчёт суммы в таблице)
Модуль объекта (справочника, документа)	Для всех экземпляров объекта	Функция `ПолучитьОстаткиТовара()` для документа РеализацияТоваровУслуг
Общий модуль	Глобальная (если указан `Экспорт`) или только для серверных вызовов	Универсальные функции вроде `ФорматироватьНомерТелефона()`
Модуль менеджера	Для всех объектов данного типа	Функция `НайтиДубликатыКонтрагентов()` в модуле менеджера справочника Контрагенты

Самый универсальный вариант — общие модули. Они позволяют переиспользовать код в разных частях конфигурации. Например, если вам нужно форматировать номера телефонов в нескольких документах, лучше вынести логику в общий модуль с функцией ФорматироватьТелефон(Номер) и вызывать её где угодно.

Как создать общий модуль в 1С?

1. Откройте конфигуратор (Файл → Открыть конфигурацию).

2. В дереве объектов найдите ветку Общие → Общие модули.

3. Нажмите правой кнопкой и выберите Добавить.

4. Укажите имя модуля (например, УтилитыРаботыСДанными).

5. В свойствах модуля отметьте флажки Глобальный (если нужен доступ из клиентских модулей) и Серверный (если функция работает с базой данных).

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

&НаСервере Функция ПолучитьДанныеИзБазы() // Код, работающий только на сервере КонецФункции &НаКлиенте Функция ОбработатьПользовательскийВвод() // Код, работающий только на клиенте

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

💡

Если функция должна работать и на сервере, и на клиенте, размещайте её в общем модуле с соответствующими директивами или используйте конструкцию &НаСервереБезКонтекста для серверных вызовов из клиентского кода.

Параметры функции: типы, значения по умолчанию и передача по ссылке

Параметры функции позволяют передавать в неё данные для обработки. В 1С параметры могут быть:

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

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

Функция УвеличитьЧисло(Знач Число) // Передача по ссылке
Число = Число + 1;
Возврат Число;
КонецФункции

Перем МоеЧисло = 5;
УвеличитьЧисло(МоеЧисло);
// Теперь МоеЧисло = 6

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

Функция СоздатьСообщение(Текст, ЦветТекста = "Чёрный", РазмерШрифта = 12) // Логика функции КонецФункции // Вызов с двумя параметрами по умолчанию:

СоздатьСообщение("Привет");

Имена параметров отражают их смысл|

Типы параметров указаны явно (если критично)|

Для опциональных параметров заданы значения по умолчанию|

Параметры, которые функция меняет, передаются по ссылке|

-->

Особое внимание уделите типизации параметров. Хотя 1С позволяет не указывать типы, явное их объявление помогает избежать ошибок. Например:

Функция РассчитатьПлощадь(Длина как Число, Ширина как Число) Возврат Длина * Ширина;

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

Если в эту функцию передать строку вместо числа, компилятор выдаст ошибку ещё на этапе написания кода, а не во время выполнения.

Возвращаемые значения: что можно вернуть из функции

Функция в 1С может возвращать любой тип данных: примитивы (Число, Строка, Дата), сложные типы (Массив, Структура, ТаблицаЗначений), а также объекты конфигурации (справочники, документы и т.д.). Главное правило: типы возвращаемого значения и оператора Возврат должны совпадать.

Рассмотрим примеры возвращаемых значений:

📌 Простое значение:

Функция ПолучитьТекущийГод()
Возврат Год(ТекущаяДата());
КонецФункции

Вернёт число (например, 2026).

📋 Структура:

Функция ПолучитьИнфоОПользователе() Возврат Новый Структура("Имя,Должность", Пользователь.Имя, Пользователь.Должность);

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

Вернёт объект типа Структура с двумя свойствами.

🗃️ Таблица значений:

Функция ПолучитьСписокТоваров()
Запрос = Новый Запрос("ВЫБРАТЬ Наименование, Цена ИЗ Справочник.Товары");
Возврат Запрос.Выполнить().Выгрузить();
КонецФункции

Вернёт таблицу с данными о товарах.

Если функция должна вернуть несколько значений, удобно использовать Структуру или Массив. Например:

Функция РазобратьФИО(ФИО как Строка)
Данные = СтрРазделить(ФИО, " ");
Возврат Новый Структура("Фамилия,Имя,Отчество", Данные[0], Данные[1], ?(Данные.Количество() > 2, Данные[2], ""));
КонецФункции

💡

Чтобы функция могла вернуть Неопределено в случае ошибки, используйте конструкцию Возврат ?(Условие, Значение, Неопределено). Это упрощает обработку исключительных ситуаций.

Если вы забудете оператор Возврат, компилятор выдаст ошибку. Также избегайте возврата Null (в 1С это Неопределено) без проверки — это может привести к ошибкам при дальнейшей обработке.

Что будет, если функция не вернёт значение?

Компилятор 1С не позволит сохранить модуль с функцией, в которой отсутствует оператор Возврат. Если же вы используете условный возврат (например, внутри Если), убедитесь, что все ветки кода ведут к Возврат, иначе получите ошибку "Не все пути выполнения возвращают значение".

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

Разберём несколько реальных примеров функций, которые часто требуются в 1С:

1. Расчёт НДС

Функция для добавления НДС к сумме с учётом флага «включён/не включён»:

Функция РассчитатьНДС(Сумма, СтавкаНДС = 20, НДСВключен = Ложь) Экспорт
Если НДСВключен Тогда
Возврат Сумма * СтавкаНДС / (100 + СтавкаНДС);
Иначе
Возврат Сумма * СтавкаНДС / 100;
КонецЕсли;
КонецФункции

2. Проверка заполненности реквизитов

Функция для проверки, заполнены ли обязательные поля документа:

Функция ПроверитьЗаполненность(Объект, СписокПолей) Экспорт
Для Каждого Поле Из СписокПолей Цикл
Если ЗначениеЗаполнено(Объект[Поле]) = Ложь Тогда
Возврат Ложь;
КонецЕсли;
Цикл;
Возврат Истина;
КонецФункции

3. Форматирование строки как телефона

Функция для приведения номера телефона к стандарту +7 (XXX) XXX-XX-XX:

Функция ФорматироватьТелефон(Номер) Экспорт
Номер = СтрЗаменить(Номер, " ", "");
Номер = СтрЗаменить(Номер, "-", "");
Если Лев(Номер, 1) = "8" Тогда
Номер = "7" + Сред(Номер, 2);
КонецЕсли;
Если Лев(Номер, 2) = "+7" Тогда
Номер = Сред(Номер, 2);
КонецЕсли;
Возврат Формат(Номер, "+7 (###) ###-##-##");
КонецФункции

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

Типичные ошибки и как их избежать

Даже опытные разработчики иногда допускают ошибки при работе с функциями. Вот самые распространённые:

🚫 Забытый Возврат — функция ничего не возвращает, хотя должна. Решение: всегда проверяйте, что все ветки кода ведут к Возврат.
🔄 Неправильная передача параметров по ссылке — функция меняет копию данных, а не оригинал. Решение: используйте Знач для параметров, которые нужно изменить.
📛 Неуникальные имена функций — конфликт имён в общих модулях. Решение: используйте префиксы (например, модУтилиты_ФорматироватьТелефон()).
🔒 Отсутствие проверки прав — функция выполняет критические действия без проверки прав пользователя. Решение: добавьте проверку ПраваДоступа() в начало функции.

Ещё одна частая проблема — рекурсия без условия выхода. Например, функция, которая вызывает саму себя бесконечно:

Функция БесконечнаяФункция(Число)
БесконечнаяФункция(Число - 1); // Нет условия остановки!
Возврат Число;
КонецФункции

Это приведёт к переполнению стека и аварийному завершению сеанса. Всегда добавляйте условие выхода:

Функция РекурсивнаяСумма(Число)
Если Число = 0 Тогда
Возврат 0;
Иначе
Возврат Число + РекурсивнаяСумма(Число - 1);
КонецЕсли;
КонецФункции

💡

Перед написанием функции спросите себя: "Могу ли я обойтись без неё?". Иногда логику проще реализовать через запрос или встроенные методы платформы. Функции нужны для переиспользуемой логики, а не для одноразовых действий.

Также обращайте внимание на производительность. Если функция выполняет тяжелые операции (например, обходит большие массивы данных), стоит добавить кэширование результатов или оптимизировать алгоритм. Например:

Перем КэшРезультатов = Новый Соответствие();

Функция ПолучитьДанныеСКэшем(Ключ)
Если КэшРезультатов.СодержитКлюч(Ключ) Тогда
Возврат КэшРезультатов[Ключ];
КонецЕсли;
// Долгое вычисление
Результат =..;
КэшРезультатов.Вставить(Ключ, Результат);
Возврат Результат;
КонецФункции

FAQ: ответы на частые вопросы

Можно ли вызвать функцию из другой функции?

Да, функции в 1С могут вызывать другие функции, в том числе сами себя (рекурсия). Главное — следить за тем, чтобы не было бесконечной рекурсии (обязательно должно быть условие выхода). Также убедитесь, что вызываемая функция доступна в текущем контексте (например, если она объявлена в другом модуле, проверьте наличие ключевого слова Экспорт).

Как передать в функцию таблицу значений?

Таблицу значений можно передать как параметр функции по значению или по ссылке. Пример:

Функция ОбработатьТаблицу(Таблица как ТаблицаЗначений) Для Каждого Строка Из Таблица Цикл // Обработка строки Цикл;

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

Если нужно изменить оригинальную таблицу, передавайте её по ссылке с ключевым словом Знач:

Функция ДобавитьСтолбец(Знач Таблица)
Таблица.Колонки.Добавить("НовыйСтолбец");
КонецФункции

Что такое директива &НаСервере и зачем она нужна?

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

Пример:

&НаСервере
Функция ПолучитьСписокКлиентов()
Запрос = Новый Запрос("ВЫБРАТЬ Наименование ИЗ Справочник.Клиенты");
Возврат Запрос.Выполнить().Выгрузить();
КонецФункции

Как документировать функции в 1С?

Для документирования кода в 1С используйте комментарии перед функцией. Хорошая практика — указывать:

Назначение функции;
Описание параметров;
Тип возвращаемого значения;
Примеры использования.

Пример:

// Рассчитывает итоговую сумму заказа с учётом скидки и НДС. // // Параметры: // Сумма - Число, сумма заказа без учёта скидки и НДС; // ПроцентСкидки - Число, процент скидки (по умолчанию 0); // СтавкаНДС - Число, ставка НДС (по умолчанию 20). // // Возвращает: Число - итоговая сумма с учётом скидки и НДС. // Функция РассчитатьИтоговуюСумму(Сумма, ПроцентСкидки = 0, СтавкаНДС = 20) Экспорт СуммаСоСкидкой = Сумма * (1 - ПроцентСкидки / 100); Возврат СуммаСоСкидкой * (1 + СтавкаНДС / 100);

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

Можно ли в 1С создать функцию, которая принимает неопределённое количество параметров?

В 1С 8.3 нет прямой поддержки переменного числа параметров (как, например, .. в JavaScript). Однако можно эмулировать это поведение, передавая параметры в виде массива:

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

// Вызов:
Результат = Суммировать(Новый Массив(1, 2, 3, 4));

Как написать функцию в 1С: от синтаксиса до практических примеров

Функция vs процедура: в чём разница и когда что использовать

Синтаксис функции в 1С: разбираем конструкцию по частям

Где размещать функции: модули и область видимости

Параметры функции: типы, значения по умолчанию и передача по ссылке

Возвращаемые значения: что можно вернуть из функции

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

1. Расчёт НДС

2. Проверка заполненности реквизитов

3. Форматирование строки как телефона

Типичные ошибки и как их избежать

FAQ: ответы на частые вопросы

📖 Читайте также