Конструктор форматной строки позволяет разработчику составить текст форматной строки исключительно визуальными средствами и предназначен для настроек правил отображения значений типа "Число", "Дата", или "Булево" в выводных формах или полях ввода данных.
Форматная строка представляет собой строковое значение, включающее параметры форматирования. Используются в конструкциях встроенного языка для того, чтобы сформировать нужное представление отображаемых данных (см. также справку 1С: Глобальный контекст (Global context) Формат (Format)).
Синтаксис:
Формат(<Значение>, <ФорматнаяСтрока>)
Тип: Строка.
Формирует удобное для чтения представление значений. Полезно использование в отчетах и при прочем визуальном отображении значений.
Параметры форматирования перечисляются через символ ";". Наличие параметра означает отличие форматирования от стандартного.
Если параметр не задан, то применяется стандартное форматирование, которое в основном соответствует преобразованию значения к строке. Однако для значений типа Число и Дата по умолчанию (0 и 01.01.0001 00:00:00 соответственно) будет выдаваться пустая строка.
Каждый параметр задается именем параметра, символом "=" и значением параметра. Значение параметра может указываться в одинарных или двойных кавычках. Это необходимо, если значение параметра содержит символы, используемые в синтаксисе форматной строки. Внутри значения параметра могут указываться произвольные символы, которые при формировании результирующей строки будут отображаться как есть. Таким образом, например, можно указывать разделители часов, минут и секунд при форматировании времени. Если эти символы совпадают со значениями форматной строки, их необходимо заключать в одинарные кавычки.
Имена и значения параметров форматной строки:
- Л (L) - имя языка, страны, для которых будет выполняться стандартное форматирование. Доступные имена языков:
- en Английский
- en_US Английский (Соединенные Штаты Америки)
- ru Русский
- ru_RU Русский (Россия)
- ru_UA Русский (Украина)
- uk Украинский
- uk_UA Украинский (Украина)
- zh Китайский
- zh_CN Китайский (Китай)
Остальные языки можно посмотреть в справке 1С.
- ЧЦ (ND) - общее число отображаемых десятичных разрядов целой и дробной частей. Исходное число округляется при этом в соответствии с правилами округления Окр15как20 (при округлении 1.5 будет округлено до 2). Если указан этот параметр, то для отображения дробной части числа обязательно указание параметра ЧДЦ, иначе дробная часть отображаться не будет.
- ЧДЦ (NFD) - число десятичных разрядов в дробной части. Исходное число округляется при этом в соответствии с правилами округления Окр15как20.
- ЧС (NS) - сдвиг разрядов: положительный - деление, отрицательный - умножение. Другими словами, это означает, что исходное число будет умножено или поделено на 10*С, где С - значение параметра по модулю.
- ЧРД (NDS) - символ-разделитель целой и дробной части.
- ЧРГ (NGS) - символ-разделитель групп целой части числа. Если в качестве разделителя использовать пустую строку, то в этом случае разделителем будет символ неразрывного пробела.
- ЧН (NZ) - строка, представляющая нулевое значение числа. Если не задано, то представление в виде пустой строки. Если задано "ЧН=", то в виде "0". Не используется для числовых полей ввода.
- ЧВН (NLZ) - если параметр указан, лидирующие нули выводятся. Если не указан - лидирующие нули не выводятся. Значение параметра игнорируется.
- ЧГ (NG) - порядок группировки разрядов числа. В качестве значения указываются числа, через запятую, обозначающие количество группируемых разрядов справа налево. Имеют смысл только два первых числа. Первое из них указывает первичную группировку, то есть ту, которая будет использована для наименее значимых разрядов целой части числа. Если второе число не указано, то будут сгруппированы только наименее значимые разряды. Если в качестве второго числа задан 0, то для всех разрядов целой части числа будет применено значение указанное для первичной группировки. Если в качестве второго числа используется значение, отличное от 0, то это значение будет использовано для группировки всех разрядов, кроме уже сгруппированных наименее значимых.
- ЧО (NN) - представление отрицательных чисел.
- 0 (0) - строка вида "(1,1)";
- 1 (1) - строка вида "-1,1";
- 2 (2) - строка вида "- 1,1";
- 3 (3) - строка вида "1,1-";
- 4 (4) - строка вида "1,1 -".
- ДФ (DF) - формат даты.
- д (d) - день месяца (цифрами) без лидирующего нуля;
- дд (dd) - день месяца (цифрами) с лидирующим нулем;
- ддд (ddd) - краткое название дня недели *);
- дддд (dddd) - полное название дня недели *);
- М (m) - минута без лидирующего нуля;
- ММ (mm) - минута с лидирующим нулем;
- МММ (MMM) - краткое название месяца *);
- ММММ (MMMM) - полное название месяца *);
- к (q) - номер квартала в году;
- г (y) - номер года без века и лидирующего нуля;
- гг (yy) - номер года без века с лидирующим нулем;
- гггг (yyyy) - номер года с веком;
- ч (h) - час в 12-часовом варианте без лидирующих нулей;
- чч (hh) - час в 12-часовом варианте с лидирующим нулем;
- Ч (H) - час в 24-часовом варианте без лидирующих нулей;
- ЧЧ (HH) - час в 24-часовом варианте с лидирующим нулем;
- м (m) - минута без лидирующего нуля;
- мм (mm) - минута с лидирующим нулем;
- с (s) - секунда без лидирующего нуля;
- сс (ss) - секунда с лидирующим нулем;
- вв (tt) - отображение половины дня AM/PM (действительно только для языков конфигурирования, поддерживающих 12 часовой вариант представления времени).
Примечание: *) - не используется для форматной строки поля ввода даты.
- ДЛФ (DLF) - локальный формат даты. Указывается вариант отображения частей даты.
- Д (D) - дата (цифрами);
- ДД (DD) - длинная дата (месяц прописью);
- В (T) - полное время, дата может объединяться со временем;
- ДВ (DT) - дата время.
Пример: выражение Формат('20051120140323',"ДЛФ=ДДВ") имеет значение "20 ноября 2005 г. 14:03:23".
Важно! Порядок следования опций форматной строки для ДЛФ <дата + время> (ДВ или ДДВ) не может быть изменен.
- ДП (DE) - строка, представляющая пустую дату (например, Формат('00010101000000' ,"ДП=""пустая дата""") вернет строку "пустая дата").
- БЛ (BF) - строка, представляющая логическое значение Ложь.
- БИ (BT) - строка, представляющая логическое значение Истина.
- ЧФ (NF) - шаблон форматирования числа. В строке можно использовать символ Ч(N) для указания позиции, в которую нужно вывести число. Число выводится с учетом остальных параметров, заданных в форматной строке. Остальные символы выводятся как есть. Символы, находящиеся между двойными или одинарными кавычками выводятся как есть. Шаблон форматирования не применяется к числу 0 (за исключением случая наличия в формате строки параметра "ЧН=").
Примечание. Использование параметров для поля ввода:
- параметр ДП (DE) не используется;
- параметр ДЛФ (DLF) используется только со значениями Д (D), В(T) и ДВ (DT).
Конструктор форматной строки можно:
- вызывать в поле ввода и ячейке табличного документа;
- использовать при написании текстов модулей.
Конструктор форматной строки поддерживает формирование форматных строк:
- для числовых значений;
- для логических значений;
- для значений типа "Дата".
Результатом работы конструктора будет являться строка, соответствующая правилам составления форматных строк и отображаемая в нижней части конструктора.
Конструктор позволяет редактировать уже имеющиеся в модуле форматные строки, для чего достаточно установить курсор внутри существующей форматной строки и вызвать конструктор.
Имеющаяся форматная строка будет проанализирована и представлена в конструкторе в виде соответствующих параметров форматирования.
Вызов конструктора форматной строки:
- через свойство "Формат" соответствующего элемента (объекта);
- через меню "Текст" - "Конструктор форматной строки...";
- через контекстное меню модуля командой "Конструктор форматной строки...".
При вызове конструктора через свойство "Формат" соответствующего элемента (объекта) созданный формат можно править прямо в поле свойства "Формат" (например, вместо yyyy сделать yy).
Через меню "Текст" - "Конструктор форматной строки..." (после установки курсора в текст модуля):
Через контекстное меню модуля командой "Конструктор форматной строки...":