Тип «Число»

Для форматирования чисел используется встроенный метод Представление(), который принимает как аргумент указанный формат и возвращает строку с числом в этом формате.

Пример

метод Скрипт()
    пер а: Число = 123.456
    пер б = а.Представление("'Результат: '6.2")
    Консоль.Записать(б)
;

Результат: 123,46

Синтаксис

В общем случае синтаксис форматной строки выглядит следующим образом: "['префикс'][флаги][ширина][.точность][специальные флаги]['суффикс']".

Вся форматная строка выделяется двойными кавычками. Префикс и суффикс указываются в отдельных одинарных кавычках (для экранирования). Являются необязательной частью форматной строки (могут не указываться). Необходимо, чтобы составляющие форматирующей части (флаги, ширина, точность, специальные флаги) следовали строго друг за другом в соответствии с синтаксисом.

Префикс

Текстовая часть форматной строки, которая добавляется перед отформатированным числом. Пример:

Для числа 123.123 применим форматную строку 'знач='7.2. Получим: знач= 123.12.

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

Для числа 123.123 применим форматную строку 'знач''='7.2. Получим: знач'= 123.12.

Флаги

Используются непосредственно для форматирования выводимого числа. В отличие от специальных флагов определяются одним символом. При указании нескольких флагов указываются без разделительных знаков, могут указываться в произвольном порядке. При заполнении "свободного места", то есть разницы между исходными и указанными шириной/точностью, заполнитель по умолчанию — пробелы слева. Список флагов:

0

Свободное место заполняется нулями слева. Несовместим с флагом -. Пример:

Для числа 123.456 применим форматную строку 08.2. Получим: 00123,46.

-

Свободное место заполняется пробелами справа. Несовместим с флагом 0. Пример:

Для числа 123.456 применим форматную строку -7.2'$'. Получим: 123,46 $.

+

Положительные числа выводятся со знаком +. Пример:

Для числа 123.456 применим форматную строку +7.2. Получим: +123,46.

_

Группировка целой части по 3 цифры, начиная с младшего разряда. По умолчанию разделителем групп является символ неразрывного пробела  . Пример:

Для числа 123456789 применим форматную строку _10.2. Получим: 123 456 789,00.

(

Отрицательные числовые значения заключаются в скобки и берутся по модулю. Пишутся без знака -. Пример:

Для числа -123.456 применим форматную строку (6.2. Получим: (123,46).

Ширина

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

Для числа 123.123 укажем ширину 10. Получим:    123.123.

Для числа 123.123 укажем ширину 1. Получим: 123.123.

Точность

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

Для числа 123.456 укажем точность .2. Получим: 123,46.

Специальные флаги

Синтаксис: специальный флаг=значение, где значение это разделитель или режим округления. Используются непосредственно для форматирования выводимого числа. В отличие от обычных флагов определяются не одним символом, а выражением. При указании нескольких флагов разделяются точкой с запятой (;), могут указываться в произвольном порядке. От предыдущей части форматной строки (если есть) также отделяются точкой с запятой. Пример: 'значение='РД=.'$'. Для удобства чтения допускается использование пробела (пробелов) для отделения специального флага от знака присваивания, но не допускается использование пробела после знака присваивания или после знака разделителя, так как в этом случае пробел будет восприниматься встроенным языком как собственно разделитель или часть разделителя. Пример: 'тест'(+_15.2; РГ =,; РД =.; ОК =ПВВ;'тест'. Список специальных флагов:

РГ

"Разделитель групп". Определяет разделитель групп в целой части. Принимает как значение символ разделителя (или символ в Unicode). Ожидается только вместе с флагом _, включающим разделение по группам. Пример:

Формат _;РГ=, для числа 123456789 даст результат 123,456,789.

РД

"Разделитель дробной". Определяет разделитель между целой и дробной частями. Принимает как значение символ разделителя (или символ в Unicode). Пример:

Формат РД=, для числа 123.456 даст результат 123,456.

ОК

"Округление". Определяет режим округления. Ожидается только вместе с указанием точности. Принимает одно из значений перечисления ВидОкругления (по умолчанию: ПВВ):

ВН

Округление "Вниз". Округляет к меньшему ближайшему целому. Пример:

Формат .0;ОК=ВН для числа 1.9 даст результат 1.

ВВ

Округление "Вверх". Округляет к большему ближайшему целому. Пример:

Формат .0;ОК=ВВ для числа 1.1 даст результат 2.

ПВН

Округление "ПоловинаВниз". Если < 5, округляет к меньшему ближайшему целому. Пример:

Формат .0;ОК=ПВН для числа 1.5 даст результат 1.

ПВВ

Округление "ПоловинаВверх". Если >= 5, округляет к большему ближайшему целому. Пример:

Формат .0;ОК=ПВВ для числа 1.5 даст результат 2.

Суффикс

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

Для числа 123.123 применим форматную строку "-6.2' руб.'". Получим: 123,12 руб.

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

Для числа 123.123 применим форматную строку "-6.2' руб.'''". Получим: 123,12 руб.'

Именованные стандартные форматы

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

"['префикс']именованный_формат['суффикс']"