Форматирование

В языке «1С:Предприятия» значение типа Число можно было отформатировать с помощью функции Формат(). В форматной строке в кавычках указывались имена параметров форматирования, знак равенства и значение параметров форматирования, разделенные символом двоеточия.

Например, чтобы вывести число 9.49 с длиной целой части – 2 знака (ЧЦ=2), длиной дробной части – 1 знак (ЧДЦ=1) и округлением в большую сторону (т. е. получить 9,5), нужно написать следующую форматную строку:

Теперь в языке «Элемента», чтобы отформатировать число, нужно либо указать форматную строку в качестве аргумента метода Представление(), либо указать ее в выражении интерполяции после выражения, которое нужно отформатировать, через «|». А перед этим выражением указать символ «$». Например:

Сама форматная строка состоит из 3 частей, следующих друг за другом непрерывно (без каких-либо символов разделителей):

• префикс;
• обязательная непустая форматирующая часть, состоящая из четырех подчастей:
  • флаги,
  • ширина,
  • точность,
  • специальные флаги;
• суффикс.

Вся форматная строка выделяется двойными кавычками. Префикс и суффикс указываются в отдельных одинарных кавычках. Префикс и суффикс являются необязательными частями форматной строки (могут не указываться).

Префикс – это непосредственно текст (какой-либо набор символов), который должен быть вставлен перед отформатированным числом. При использовании символа «'» (одинарная кавычка) в префиксе его необходимо экранировать: «''» (две подряд идущие одинарные кавычки). Например:

Флаги позволяют управлять форматом строки с обрабатываемым числом. Флаги влияют на свободное место (количество символов, которого не хватает в отформатированном числе до указанной ширины) слева или справа от числа, знак, выводимый перед числом, и т. п.:

• "0" – свободное место будет заполнено нулями слева (не совместим с флагом "-");
• "-" – свободное место будет заполнено пробелами справа (не совместим с флагом "0");
• "+" – положительные числа выводятся со знаком "+";
• "_" – группировка целой части по 3 цифры, начиная с младшего разряда (по умолчанию разделителем групп является символ неразрывного пробела " ");
• "(" – отрицательные числовые значения заключаются в скобки и берутся по модулю (пишутся без знака -).

Если необходимо указать несколько флагов, они указываются в форматной строке в любом порядке друг за другом без разделительных символов. Флаги могут не указываться в форматной строке. Например:

Ширина форматной строки контролирует общую итоговую ширину вывода форматируемого числа (в данном значении не учитывается текст, идущий на префиксе и суффиксе, – он отдельно приписывается до и после строки, содержащей отформатированное число, соответственно). Ширина включает разделитель дробной и целой части.

Если указанной ширины не хватает для вывода числа с соблюдением всех флагов, а также специальных флагов или ширина вообще не указана, то она динамически расширяется до минимально необходимой для вывода отформатированного числа.

Если же ширина больше необходимой для вывода отформатированного числа, то свободное место заполняется в соответствии с указанными флагами. По умолчанию свободное место заполняется пробелами слева. Например:

Точность – это часть форматной строки, которая выводится через точку от ширины. Она задает, сколько цифр должно выводиться в дробной части числа. Если указанное количество цифр меньше, чем в исходном числе, то значение округляется (по умолчанию 1.5?2). Режим округления задается при помощи соответствующего специального флага (ОК). Если указанное количество цифр больше, дробная часть дополняется нулями с конца. Например:

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

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

Как и обычные флаги, они могут указываться в произвольном порядке, но обязательно должны отделяться друг от друга (а также от предыдущей части форматной строки) символом «;» (точка с запятой). Имена специальных флагов можно отделять пробелом от разделителей («;») и знака равенства, а значения этих флагов – нет.

То есть подряд последовательно должны идти знак присваивания (=), значение специального флага и знак-разделитель (;).

Специальные флаги могут иметь вид:

• "РГ=X" – Ввод знака-разделителя групп в целой части (вместо X ожидается какой-либо символ (либо код символа в формате \uкод)). Данный специальный флаг ожидается только вместе с флагом "_", включающим разделение по группам.
• "РД=X" – Ввод знака-разделителя между целой и дробной частью (вместо X ожидается какой-либо символ (либо код символа в формате \uкод)).
• "ОК=РЕЖИМ" – Флаг-режим округления. Если флаг не указан, по умолчанию округление имеет значение ПоловинаВверх. Имеет 4 режима, которые совпадают с режимами перечисления ВидОкругления:
  • "ОК=ВН" – округление вниз (1.9->1);
  • "ОК=ВВ" – округление вверх (1.1->2);
  • "ОК=ПВН" – округление половина – вниз (1.5->1);
  • "ОК=ПВВ" – округление половина – вверх (1.5->2).

Специальные флаги могут не указываться в форматной строке.

Например:

Суффикс – это отдельная часть форматной строки, добавляемая в итоговой отформатированной строке после отформатированного числа.

При использовании символа «'» (одинарная кавычка) в суффиксе его необходимо экранировать: «''» (две подряд идущие одинарные кавычки). Например:

Для упрощения работы с форматными строками существуют также именованные стандартные форматы, которые заменяют часть с описанием форматирования числа и упрощают написание форматных строк.

Существуют следующие именованные форматы:

• "Деньги"

Например:

• "Процент"

Например:

• "ОснованиеХХ"

Например:

Основание переводит число из десятеричной системы счисления в другую. Например, символ перевода строки в таблице ASCII имеет десятичный код 10, а шестнадцатеричный код A. Если в переменной есть десятеричный код этого символа, можно сразу получить его шестнадцатеричный код.

Отправить