В процессе разработки часто возникает задача сформировать уникальный идентификатор или строку поиска, которая объединяет дату документа и его номер в сплошной набор цифр (например, для интеграции с внешними системами или быстрого поиска). На первый взгляд задача кажется простой — достаточно преобразовать значения в строки и соединить их. Однако при неправильном подходе программисты сталкиваются с ошибками форматирования, зависимостью от настроек сервера и проблемами производительности. В этой статье мы разберем, как пройти путь от громоздкого нерабочего кода до элегантного решения в одну строку.
Рассмотрим типичную ошибку начинающего разработчика. Попытка вручную «разрезать» дату на части с помощью функций Лев(), Сред() и Найти() приводит к непредсказуемым результатам.
НомерБезНуля = Формат(Число(Объект.Номер), "ЧГ=0");
СимволДаты = Найти(Объект.Дата, ".");
ДеньДаты = Лев(Объект.Дата, СимволДаты - 1);
// ... и так далее для всех компонентов даты
Давайте проанализируем, почему этот код выдает некорректные данные, такие как «25127:5325.12.2021...». Главная причина кроется в специфике типа данных Дата в 1С. Дата — это не строка, а объект. Когда вы передаете объект типа Дата в функцию Найти() или Лев(), платформа 1С выполняет **неявное преобразование** даты в строку. Это преобразование зависит от локальных настроек операционной системы на сервере или клиенте (региональные стандарты Windows/Linux).
Если формат даты в системе изменится (например, с «ДД.ММ.ГГГГ» на «ГГГГ-ММ-ДД»), логика поиска символов «развалится». Именно поэтому попытки искать точки или двоеточия в объекте даты напрямую являются грубой ошибкой проектирования.
Более надежный, но все еще избыточный способ — это использование функции Формат() для получения строкового представления с последующим удалением разделителей. Рассмотрим этот пример:
НомерДокументаБезНуля = Формат(Число(Объект.Номер), "ЧГ=0");
ДатаДляСтроки = СтрЗаменить(Формат(Объект.Дата, "ДФ=dd.MM.yyyy"), ".", "");
ВремяДляСтроки = СтрЗаменить(Формат(Объект.Дата, "ДЛФ=T"), ":", "");
СтрокаДляПоискаДокумента = СокрЛП(ДатаДляСтроки + ВремяДляСтроки + НомерДокументаБезНуля);
Здесь мы видим явный прогресс: используется функция Формат(), которая гарантирует стабильный результат независимо от настроек системы. Однако код остается громоздким из-за лишних вызовов СтрЗаменить(). Мы сначала просим систему добавить точки, а затем сами же их удаляем. Давайте выясним, как сделать это эффективнее.
Самый правильный и производительный способ — задать формат даты таким образом, чтобы он сразу возвращал строку без разделителей. Для этого используется параметр ДФ (формат даты). Посмотрим на финальный вариант кода:
НомерДокументаБезНуля = Формат(Число(Объект.Номер), "ЧГ=0");
ДатаДляСтроки = Формат(Объект.Дата, "ДФ=ddMMyyyyHHmmss");
СтрокаДляПоискаДокумента = СокрЛП(ДатаДляСтроки + НомерДокументаБезНуля);
В данном случае строка ddMMyyyyHHmmss расшифровывается следующим образом:
Многие разработчики не могут найти подобные конструкции в стандартном конструкторе 1С. Разберем по шагам, как это сделать правильно:
При использовании данного подхода необходимо учитывать несколько критических моментов, которые могут привести к ошибкам в будущем.
1. Риски функции Число() для номера документа. В примерах выше используется Число(Объект.Номер) для удаления ведущих нулей. Помните: это сработает только в том случае, если ваш номер состоит исключительно из цифр (например, «00000123»). Если в конфигурации используется префиксация (например, «БП-001» или «УТ0005»), функция Число() вызовет фатальную ошибку. Для безопасного удаления нулей в строковых номерах лучше использовать специализированные функции типовых конфигураций (БСП) или искать первый ненулевой символ циклом.
2. Пустые значения даты. Если Объект.Дата не заполнена (пустая дата 01.01.0001), функция Формат() вернет строку «01010001000000». Проанализируйте ситуацию: нужно ли вам формировать поисковый индекс для незаполненных документов? Возможно, стоит добавить проверку на ЗначениеЗаполнено().
3. Производительность и индексы. Если такая строка используется для частого поиска в большой базе данных, крайне не рекомендуется вычислять её «на лету» в запросах или коде. Правильнее будет создать в документе отдельный реквизит СтрокаПоиска, установить для него свойство «Индексировать» и заполнять его один раз при записи документа. Это позволит системе мгновенно находить документы даже среди миллионов записей.
Используя эти методы, вы не только сократите объем кода, но и сделаете его устойчивым к изменениям системных настроек и высокопроизводительным.