Другое · 7 мин
Литерал даты в 1С: практическое руководство
Разберём, что такое литерал даты в 1С, как его записывать в коде и запросах, где возникают ошибки при сравнении и как проверить результат без риска порчи данных.
Литерал даты в 1С — это способ задания конкретной даты прямо в тексте программы или запроса, без обращения к реквизиту документа или справочника. В языке встроенной литерал обычно пишется в кавычках в формате, который платформа распознаёт как дату, например «20250101».
Такой литерал нужен, когда требуется задать фиксированную границу: начало периода, дата отсечения, срок исполнения или значение по умолчанию. Он используется в модулях объектов, общих модулях, запросах и конструкторах отборов.
Главная особенность в том, что литерал даты не является полем базы данных. Это константа, которую интерпретатор преобразует в значение типа Дата перед сравнением или записью. Если преобразование проходит некорректно, появится ошибка или неверный результат отбора.
Что понимают под литералом даты в 1С
Литерал даты — это не переменная и не реквизит, а заданное разработчиком значение. Оно существует только в момент выполнения кода или составления запроса и не хранится отдельно в информационной базе, если не записано в объект.
В коде на встроенном языке литерал часто записывается в кавычки, а платформа сама определяет, что это дата, если контекст требует типа Дата. Например, сравнение «Документ.Дата >= '20250101'» означает отбор документов, дата которых не ранее указанного дня.
Важно отличать литерал от функции получения текущей даты. Литерал задаёт конкретный день, а функции вроде ТекущаяДата() возвращают значение, которое меняется в зависимости от момента запуска. Для старых отчётов и архивных данных литерал подходит лучше, чем динамическая дата.
Формат записи литерала даты
В 1С литерал даты обычно оформляется в кавычках и записывается цифрами без разделителей или с разделителями, в зависимости от контекста и настроек платформы. Наиболее надёжный вариант — компактный формат, который меньше зависит от региональных параметров пользователя.
Если дата включает время, литерал может содержать часы, минуты и секунды. При указании только даты время может дополняться нулями автоматически, что иногда влияет на сравнение: дата «20250101» может интерпретироваться как начало суток, а запись с временем — как конкретный момент.
Перед использованием нестандартного формата стоит проверить, как платформа интерпретирует строку в текущей конфигурации. Разные варианты записи могут приводить к разным результатам при сравнении с полями типа Дата из базы.
Где применяется литерал даты
В запросах литерал даты часто используется в секции ГДЕ для ограничения периода: выборка продаж за январь, отбор документов после указанной даты, фильтр по дате проведения. В этом случае литерал сравнивается с полями регистров, документов и справочников.
В коде модулей литерал применяется при заполнении реквизитов, расчёте сроков, проверке просрочки и формировании отборов в динамических списках. Например, условие «Если ДатаДокумента >= '20250101' Тогда» позволяет разделить обработку по датам.
В конструкторах отчётов и обработок литерал может задаваться в параметрах отбора, чтобы пользователь не вводил дату вручную каждый раз. Это удобно для типовых отчётов за фиксированный период, но снижает гибкость, если период нужно менять часто.
Сравнение дат и неявное преобразование
Платформа пытается привести литерал к типу Дата перед сравнением, но это не всегда происходит без потерь. Если формат строки не распознан, может возникнуть ошибка при выполнении или некорректное сравнение, когда дата считается меньше или больше ожидаемой.
Особенно осторожно нужно работать с датами, содержащими время. Сравнение только даты с полем, где хранится дата и время, может дать неожиданный результат: документ за вечер указанного дня может не попасть в отбор, если отбор ограничен началом суток.
Безопасный способ проверки — вывести значение литерала и значение поля в сообщение или отладку перед сравнением. Так можно увидеть, привелась ли строка к ожидаемой дате и нет ли смещения по времени или часовому поясу.
Частые ошибки при работе с литералами дат
Одна из типичных ошибок — запись даты с разделителями, которые платформа не распознаёт в текущем контексте. В результате код завершается ошибкой или сравнение всегда возвращает ложь, хотя данные в базе есть.
Другая ошибка — использование текстового месяца вместо цифрового. Название месяца зависит от языка интерфейса, поэтому такой литерал может работать на одном компьютере и не работать на другом с другой локалью.
Ещё одна проблема — сравнение литерала даты со строкой без приведения типов. Если одно значение остаётся текстом, а другое преобразуется в дату, результат может быть непредсказуемым. Лучше явно приводить оба значения к одному типу перед сравнением.
- 1Запишите литерал в кавычках в компактном формате.
- 2Проверьте тип поля, с которым ведётся сравнение.
- 3Проведите отбор на тестовой копии базы.
- 4Сравните результат с ожидаемым списком документов.
Как безопасно проверять и использовать литералы дат
Перед внедрением в рабочую базу проверьте литерал на копии или в тестовой базе. Убедитесь, что отбор возвращает ожидаемые документы, а сравнение не пропускает граничные случаи, например документы в последний день периода.
Если литерал используется в запросе, посмотрите план выполнения и количество возвращаемых строк. Слишком широкий отбор может замедлить работу, а слишком узкий — скрыть нужные данные. При больших объёмах данных индексы по датам помогают, но только если типы полей и литерала совместимы.
Как проверить результат
Возвращает ожидаемые документы за период
Пропускает документы или возвращает пустой результат
Альтернативы фиксированному литералу
Если дата должна меняться в зависимости от ситуации, лучше использовать параметры запроса, реквизиты формы или функции получения даты, а не жестко заданный литерал. Это упрощает поддержку и делает код менее чувствительным к изменению отчётного периода.
Для массовых операций с датами удобно выносить граничные значения в константы или настройки информационной базы. Тогда изменение периода потребует правки одного значения, а не поиска всех литералов в модулях.
Что важно запомнить
Литерал даты — это фиксированное значение в кавычках; перед использованием проверяйте формат, тип поля и результат отбора на тестовой копии.
Нужно ли всегда брать литерал даты в кавычки?
В большинстве контекстов встроенного языка дата задаётся строкой в кавычках, которую платформа преобразует к типу Дата. Точное оформление зависит от места использования, поэтому стоит проверить поведение в конкретном модуле или запросе.
Почему отбор по литералу даты может не находить документы?
Возможны несовпадение форматов, разница между датой и датой со временем, а также неявное преобразование типов. Проверка значения в отладке поможет найти причину.
Можно ли использовать название месяца в литерале даты?
Названия месяцев зависят от языка интерфейса, поэтому такой литерал менее переносим. Надёжнее использовать цифровой формат даты.
Чем заменить жёсткий литерал в отчёте?
Подойдут параметры запроса, реквизиты формы, настройки базы или функции получения текущей даты, если период должен определяться автоматически.