Формирует внешнее представление периода, заданного датами начала и окончания периода.
Синтаксис
ПредставлениеПериода(<ДатаНачалаПериода>, <ДатаОкончанияПериода>, <ФорматнаяСтрока>)Примеры платформы
ТекДата = ТекущаяДата();
НачДата = НачалоМесяца(ТекДата);
КонДата = КонецМесяца(ТекДата);
Описание = "" + ПредставлениеПериода(НачДата, КонДата, "ФП = Истина");Полное описание, параметры и ограничения
Глобальный контекст.ПредставлениеПериода (Global context.PeriodPresentation)
Глобальный контекст (Global context)
ПредставлениеПериода (PeriodPresentation)
Доступен, начиная с версии 8.0.
Синтаксис:
ПредставлениеПериода(<ДатаНачалаПериода>, <ДатаОкончанияПериода>, <ФорматнаяСтрока>)
Параметры:
<ДатаНачалаПериода> (обязательный)
Тип: Дата.
Дата начала периода.
<ДатаОкончанияПериода> (обязательный)
Тип: Дата.
Дата окончания периода.
<ФорматнаяСтрока> (необязательный)
Тип: Строка.
Определяет способ форматирования периода.
Может содержать следующие параметры:
Л/L - код локализации. Если не указан, берется код локализации по умолчанию. Если система не поддерживает форматирование периода с указанной локализацией, генерируется исключительная ситуация.
ФП/FP - признак "финансовый период". Влияет на форматирование в случае, если указанный датами период соответствует первому полугодию или первым 9 месяцам года. Если не указан, признак не установлен.
Коды региональных установок, использование которых допустимо в форматной строке (в формате Код - Язык):
en_US - Английский,
az – Азербайджанский,
be_BY – Белорусский,
bg_BG – Болгарский,
hu – Венгерский,
vi_VN – Вьетнамский,
ka_GE – Грузинский,
kk_KZ – Казахский,
lv_LV – Латышский,
lt_LT – Литовский,
de_DE – Немецкий,
pl_PL – Польский,
ro_RO – Румынский,
ru_RU – Русский,
tr_TR – Турецкий,
tk – Туркменский,
uk_UA – Украинский,
fi_FI – Финский,
fr_CA – Французский,
et_EE – Эстонский.
Пример форматной строки:
Л=en_US; ФП=Истина
Значение по умолчанию: Пустая строка.
Возвращаемое значение:
Тип: Строка.
Описание:
Формирует внешнее представление периода, заданного датами начала и окончания периода.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение.
Примечание:
Если задан режим совместимости НеИспользовать, то по умолчанию использует код локализации, заданный для сеанса (параметром VL), аналогично форматированию числа и даты.
Пример:
ТекДата = ТекущаяДата();
НачДата = НачалоМесяца(ТекДата);
КонДата = КонецМесяца(ТекДата);
Описание = "" + ПредставлениеПериода(НачДата, КонДата, "ФП = Истина");
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Сформировать заголовок отчёта за полный и неполный период
Показываем различие финансового первого полугодия и произвольного диапазона. Строка предназначена человеку, а не обмену или фильтрации дат.
Где и как запускать
Полный серверный общий модуль учебной копии. Только чтение настроек и вычисления в памяти.
Подготовка
Работайте в отдельной учебной копии базы. Создайте серверный общий модуль УчебныеЗадачи, вставьте полный модуль урока и вызовите ВыполнитьПример() из серверного обработчика учебной команды.
Код выполняется на сервере: часть функций локализации и часовых поясов недоступна непосредственно в тонком клиенте. Реквизиты пользователя, региональные настройки и часовые пояса код не меняет.
Для двух уроков о метаданных используйте копию КА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));
КонецПроцедурыРазбор по шагам
Границы полного полугодия включают первый день с 00:00:00 и последний с 23:59:59. КонецДня задаёт эту границу явно.
Л=ru_RU выбирает документированную русскую локализацию именно функции ПредставлениеПериода.
ФП=Истина влияет на представление первого полугодия и первых девяти месяцев полного года. Флаг не превращает произвольные даты в полное полугодие.
Выводим фактические строки установленной платформы. Не утверждаем точное написание пробелов и сокращений независимо от версии.
Для отбора отчёта передавайте исходные Дата начала/окончания; возвращённую подпись не разбирайте обратно в даты.
Как проверить результат
Три непустых заголовка и четыре контрольных Истина. Сравните календарную и финансовую подписи для полного диапазона.
Неполный диапазон 10.01–20.06 должен описывать свои фактические границы, а не служить основанием расширить отбор до всего полугодия.
Ожидаемый результат
Получены понятные заголовки без изменения действительных границ отбора.
На что обратить внимание
Поддерживаемые локализации этой функции перечислены отдельно в справке. Общий каталог локализаций шире.
Сформированное представление не является стабильным машинным форматом даты.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.