Сформировать заголовок отчёта за полный и неполный период

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

Подготовка

1. Работайте в отдельной учебной копии базы. Создайте серверный общий модуль УчебныеЗадачи, вставьте полный модуль урока и вызовите ВыполнитьПример() из серверного обработчика учебной команды.

2. Код выполняется на сервере: часть функций локализации и часовых поясов недоступна непосредственно в тонком клиенте. Реквизиты пользователя, региональные настройки и часовые пояса код не меняет.

3. Для двух уроков о метаданных используйте копию КА2 Progress: в исходном Languages/Русский.xml действительно есть язык Русский с КодЯзыка = ru. Остальные уроки не требуют объектов конкретной конфигурации.

Процедура ВыполнитьПример() Экспорт
    Начало = Дата(2026, 1, 1);
    Конец = КонецДня(Дата(2026, 6, 30));
    Календарный = ПредставлениеПериода(Начало, Конец, "Л=ru_RU");
    Финансовый = ПредставлениеПериода(Начало, Конец, "Л=ru_RU; ФП=Истина");
    Неполный = ПредставлениеПериода(Дата(2026, 1, 10), КонецДня(Дата(2026, 6, 20)), "Л=ru_RU; ФП=Истина");
    Сообщить("Календарный период: " + Календарный);
    Сообщить("Финансовый период: " + Финансовый);
    Сообщить("Неполный диапазон: " + Неполный);
    Сообщить(НЕ ПустаяСтрока(Календарный));
    Сообщить(НЕ ПустаяСтрока(Финансовый));
    Сообщить(НЕ ПустаяСтрока(Неполный));
    Сообщить(Конец = Дата(2026, 6, 30, 23, 59, 59));
КонецПроцедуры

Разбор по шагам

1. Границы полного полугодия включают первый день с 00:00:00 и последний с 23:59:59. КонецДня задаёт эту границу явно.

2. Л=ru_RU выбирает документированную русскую локализацию именно функции ПредставлениеПериода.

3. ФП=Истина влияет на представление первого полугодия и первых девяти месяцев полного года. Флаг не превращает произвольные даты в полное полугодие.

4. Выводим фактические строки установленной платформы. Не утверждаем точное написание пробелов и сокращений независимо от версии.

5. Для отбора отчёта передавайте исходные Дата начала/окончания; возвращённую подпись не разбирайте обратно в даты.

Как проверить результат

1. Три непустых заголовка и четыре контрольных Истина. Сравните календарную и финансовую подписи для полного диапазона.

2. Неполный диапазон 10.01–20.06 должен описывать свои фактические границы, а не служить основанием расширить отбор до всего полугодия.

Ожидаемый результат

Получены понятные заголовки без изменения действительных границ отбора.

На что обратить внимание

1. Поддерживаемые локализации этой функции перечислены отдельно в справке. Общий каталог локализаций шире.

2. Сформированное представление не является стабильным машинным форматом даты.

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