Форматная строка используется в функции Формат() для представления значений простых типов (Число, Дата и Булево) в строковом виде.
Форматная строка представляет собой строковое выражение, состоящее из параметров форматирования, перечисленных через точку с запятой (;). Каждый параметр задается именем параметра и значением, указанным после символа равно (=). Значение параметра может заключаться в одинарные кавычки (‘). Например:
"Л=ru; ЧЦ=15; ЧДЦ=2; ДФ='dd.MM.yyyy'"
Общие параметры форматной строки
| Имя параметра | Описание |
|---|---|
| Л (L) | имя языка или страны, для которых будет выполняться стандартное форматирование. Доступные варианты:
С полным перечнем кодов языков и стран можно ознакомиться в синтакс-помощнике в режиме 1С:Конфигуратор |
Параметры форматной строки для типа Число
| Имя параметра | Описание | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| ЧЦ (ND) | устанавливает общую длину представления числа (целой и дробной частей вместе взятых). При этом исходное число округляется в соответствии с общепринятыми правилами округления (0.5 как 1). Если этот параметр задан, то для отображения дробной части числа обязательно указание следующего параметра ЧДЦ, иначе дробная часть отображаться не будет.
ЧЦ=15 |
||||||||||
| ЧДЦ (NFD) | устанавливает длину дробной части представления числа. Исходное число округляется при этом в соответствии с общепринятыми правилами округления (0.5 как 1).
ЧДЦ=2 |
||||||||||
| ЧС (NS) | устанавливает сдвиг разрядов: положительный — деление, отрицательный — умножение. Иными словами, исходное число будет умножено или поделено на 10 в степени n, где n — значение параметра | ||||||||||
| ЧРД (NDS) | устанавливает символ-разделитель целой и дробной части
ЧРД=. |
||||||||||
| ЧРГ (NGS) | устанавливает символ-разделитель триад целой части числа. Если в качестве разделителя использовать пустую строку, то в этом случае разделителем будет символ неразрывного пробела
ЧРГ= |
||||||||||
| ЧН (NZ) | устанавливает представление для нулевого значения числа. По умолчанию число 0 представляется в виде пустой строки. Если задано только имя параметра, а значение не задано, то число 0 выводится как есть.
ЧН= Внимание! Для числовых полей ввода этот параметр игнорируется
|
||||||||||
| ЧВН (NLZ) | определяет вывод лидирующих нулей для числа: если параметр задан, лидирующие нули выводятся; если не задан — не выводятся
ЧВН= |
||||||||||
| ЧГ (NG) | определяет порядок группировки разрядов числа. В качестве значения указываются числа, через запятую, обозначающие количество группируемых разрядов справа налево. Имеют смысл только два первых числа. Первое из них указывает первичную группировку, которая будет использована для наименее значимых разрядов целой части числа. Если второе число не указано, то будут сгруппированы только наименее значимые разряды. Если в качестве второго числа задан 0, то для всех разрядов целой части числа будет применено значение указанное для первичной группировки. Если в качестве второго числа используется значение, отличное от 0, то это значение будет использовано для группировки всех разрядов, кроме уже сгруппированных наименее значимых.
ЧГ=3,0 |
||||||||||
| ЧО (NN) | определяет код представления отрицательных чисел. Возможные варианты:
ЧО=1 |
||||||||||
| ЧФ (NF) | задает шаблон форматирования числа. Позиция исходного числа, отформатированного с учетом остальных параметров, указывается символом Ч. Остальные символы выводятся как есть. Символы, находящиеся между двойными или одинарными кавычками выводятся как есть
ЧФ='Ч тыс' Внимание! Шаблон форматирования не применяется к числу 0, если только в форматной строке не присутствует параметр
ЧН |
Примеры форматной строки для числовых значений:
| Форматная строка | Исходное число | Представление |
|---|---|---|
| ЧЦ=15 | 987 654,521 | 987 655 |
| ЧЦ=15; ЧДЦ=2 | 987 654,521 | 987 654,52 |
| ЧЦ=15; ЧДЦ=2; ЧГ=0 | 987 654,521 | 987654,52 |
| ЧЦ=15; ЧДЦ=2; ЧС=3; ЧФ=’Ч тыс’ | 987 654,521 | 987,65 тыс |
Параметры форматной строки для типа Дата
| Имя параметра | Описание | ||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ДФ (DF) | задает произвольный шаблон даты с помощью постановочных символов:
ДФ='dd.MM.yyyy' |
||||||||||||||||||||||||||||||||||||||||||
| ДЛФ (DLF) | задает фиксированный локальный формат даты (составленный с учетом особенностей региональных установок ИБ). Возможные варианты:
ДЛФ=ДВ Внимание! Для поля ввода типа Дата параметр используется только со значениями Д (D), В(T) и ДВ (DT)
|
||||||||||||||||||||||||||||||||||||||||||
| ДП (DE) | представление пустой даты. По умолчанию, пустая дата выводится пустой строкой. Если задано только имя параметра, а значение не задано, то пустая дата выводится в виде 01.01.0001 0:00:00
ДП=- Внимание! Параметр не используется для поля ввода даты!
|
Примеры форматной строки для типа Дата:
| Форматная строка | Исходная дата | Представление |
|---|---|---|
ДФ=dd.MM.yyyy |
24.10.2019 10:15:30 | 24.10.2019 |
ДФ='MMMM yyyy ''г.''' |
24.10.2019 10:15:30 | Октябрь 2019 г. |
ДЛФ=DD |
24.10.2019 10:15:30 | 24 октября 2019 г. |
Параметры форматной строки для типа Булево
| Имя параметра | Описание |
|---|---|
| БЛ (BF) | задает строковое представление логического значения ЛОЖЬ
БЛ=Нет |
| БИ (BT) | задает строковое представление логического значения ИСТИНА
БЛ=Да |