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

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

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

Доступ к функциям осуществляется напрямую по имени, без необходимости подключения дополнительных модулей или указания префиксов, что существенно упрощает синтаксис. Тем не менее, Игнорирование этих ограничений приведет к ошибкам выполнения, которые могут быть неочевидны на этапе написания кода.

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

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

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

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

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

Работа со строковыми данными и текстом

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

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

• 🔍 СтрНайти() — поиск позиции подстроки с учетом или без учета регистра.
• 🔄 СтрЗаменить() — замена всех вхождений одной подстроки на другую.
• ✂️ СтрПолучитьСтроку() — получение строки из многострочного текста по номеру.
• 📏 СтрДлина() — возвращает количество символов в строке.

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

Особенности кодировки при работе с файлами

При чтении текстовых файлов важно явно указывать кодировку (например, UTF-8), иначе символы национальных алфавитов могут отобразиться некорректно.

Манипуляции с датами и временем

Учет времени является основой любой ERP-системы. Функции работы с датами в 1С позволяют выполнять сложные расчеты периодов, определять начало и конец интервалов, а также форматировать даты для отображения. Функция ТекущаяДата() возвращает текущую дату и время системы, что часто используется для установки даты документа по умолчанию.

Одной из самых мощных функций в этом разделе является НачалоПериода() и КонецПериода(). Они позволяют автоматически определять границы месяца, квартала или года для переданной даты. Это избавляет разработчика от необходимости писать сложные условия для вычисления последнего дня месяца, учитывая високосные годы.

Функция	Описание	Пример результата
НачалоДня()	Усекает время, оставляя 00:00:00	20.10.2023 00:00:00
КонецДня()	Усекает время, оставляя 23:59:59	20.10.2023 23:59:59
ДобавитьМесяц()	Сдвигает дату на указанное кол-во месяцев	20.11.2023 (при сдвиге на +1)
РазностьДат()	Вычисляет разницу между датами в заданной единице	30 (дней)

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

Математические вычисления и работа с числами

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

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

При работе с процентами и долями важно использовать правильное округление. Стандартное математическое округление может не подходить для финансовых расчетов, где часто применяется банковское округление или округление до четного. В таких случаях необходимо внимательно настраивать режимы функции Окр() или писать собственные алгоритмы.

Работа с файлами и внешними данными

Интеграция с файловой системой — частая задача при обмене данными с другими системами или выгрузке отчетов. Функции КаталогВременныхФайлов() и ПолучитьИмяВременногоФайла() позволяют безопасно создавать временные объекты, которые будут автоматически удалены системой после завершения сеанса. Это предотвращает засорение диска сервера или рабочей станции.

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

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

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

Транзакции и блокировки данных

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

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

Помимо транзакций, для предотвращения конфликтов записи используются блокировки. Функция БлокировкаДанных() позволяет явно заблокировать выбранные записи до момента завершения транзакции. Это необходимо в высоконагруженных системах, где два пользователя могут попытаться изменить один и тот же остаток одновременно.

НачатьТранзакцию();
Попытка
// Логика изменения данных
ЗафиксироватьТранзакцию();
Исключение
ОтменитьТранзакцию();
Сообщить("Ошибка записи: " + ОписаниеОшибки());
КонецПопытки;

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

Уровни изоляции транзакций

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

Диагностика и отладка функций

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

Функция ЖурналРегистрации() позволяет записывать события в системный журнал 1С. Это основной инструмент для отладки фоновых процессов, регламентных заданий и серверных вызовов. Записи в журнале сохраняются даже после завершения сеанса, что позволяет ретроспективно анализировать причины сбоев.

• 📢 Сообщить() — вывод информации пользователю в интерфейс (только клиент).
• 📝 ЖурналРегистрации() — запись событий в системный лог (сервер/клиент).
• 🛑 ВызватьИсключение() — принудительная генерация ошибки для прерывания выполнения.
• 🕵️ ПолучитьИмяКомпьютера() — идентификация рабочей станции пользователя.

При обработке исключительных ситуаций конструкция Попытка..Исключение является стандартом. Внутри блока исключения полезно использовать функцию ОписаниеОшибки(), которая возвращает подробный текст проблемы, включая номер строки кода и стек вызовов. Это значительно ускоряет поиск дефектов в сложных конфигурациях.

⚠️ Внимание: Не используйте функцию Сообщить() в коде, который выполняется в фоновых заданиях или на сервере без активного пользовательского сеанса. Сообщения просто будут потеряны, и вы не узнаете об ошибке. Используйте журнал регистрации.

Где найти полный список всех функций 1С в конфигураторе?

Полный список встроенных функций доступен через меню Справка -> Синтаксис помощник в режиме Конфигуратора. Также можно нажать F1 в любом месте редактора кода для вызова контекстной справки по функции, курсор на которой установлен.

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

Да, вы можете создавать общие модули с экспортируемыми процедурами и функциями. Если в свойствах общего модуля установлена галочка "Глобальный", его методы будут доступны во всех контекстах так же, как и встроенные функции платформы.

В чем разница между Процедурой и Функцией в 1С?

Функция обязательно должна возвращать значение с помощью оператора Возврат и может использоваться в выражениях (например, внутри запроса или присваивания). Процедура не возвращает значения и используется для выполнения действий, таких как запись в базу или открытие формы.

Как узнать, доступна ли функция на клиенте или сервере?

В синтаксис-помощнике рядом с названием функции есть значки: монитор (клиент), сервер (сервер) или оба сразу. Если значка сервера нет, вызов функции из серверного кода вызовет ошибку выполнения.