Форматная строка – это набор символов, определяющий как некоторое (например, числовое) значение должно преобразовываться в текстовое представление. Для чисел форматная строка определяет длину целой и дробной части, и используемые разделители триад и дробной части.
Общий формат обозначается строкой "@". Это включает формат по умолчанию. Для чисел это означает, что:
Числовые форматы определяют правила форматирования числовых значений. Признак числового формата: первый символ должен быть буквой “N” или «Ч». Например: «Ч.2”.
Основной вид формата: “Nm.n”, где
Например: «Ч10.2». Общая длина, естественно, должна быть больше или равна длине дробной части. Если это не выполнено, то для форматирования числа будет использован формат по умолчанию.
Если длина дробной части числа превышает заданную в формате, то число округляется до требуемого количества знаков после запятой по стандартным математическим правилам.
Перед общей длиной числа может стоять последовательность "(0)". Это означает, что если длина числа меньше заданной, то представление числа будет дополняться слева нулями, чтобы достигнуть заданной длины. Например, для формата «Ч(0)6.2» число 34 будет отформатировано как “0034”. Если же длина числа больше заданной, то число будет отображаться как есть. В отличие от 1С:Предприятия 7.7 в Йокселе принято правило, что число не должно искажаться, если оно длиннее, чем задано в формате. Т.е. число 123456 для формата «Ч3.2” отобразится как “9.9”, а в Йокселе как “123456”.
Перед длиной дробной части может стоять символ “0”. Например: «Ч10.02”. Это означает, что длина дробной части фиксирована и, если длина дробной части меньше, чем заданная, то число будет дополнено нулями справа до достижения требуемой длины. Например, для формата «Ч.02” число 34.6 будет выглядеть как “34.60”, а число 5 как “5.00”.
Сразу после длины дробной части может следовать произвольный символ – символ-разделитель дробной части. Например, для формата «Ч.2-» число 123.45 будет отформатировано как “123–45”.
Сразу после разделителя дробной части может следовать другой произвольный символ – символ разделитель триад. Если этот символ присутствует, то при форматировании это включает режим группировки цифр целой части числа по 3 цифры в группе. Группы будут отделяться друг от друга символом, указанным в форматной строке. Например, для формата «Ч.02. " число 123456789 будет отформатировано как “123 456 789.00”.
После символов разделителей триад и дробной части или вместо них может идти последовательность “>m”, где m – произвольное число. Эта последовательность включает арифметический «сдвиг» при форматировании. Если число m – положительно, то перед форматированием заданное число сдвигается вправо на заданное количество десятичных позиций (делится на 10 в степени m). Если m – отрицательно, то число сдвигается влево (умножается на 10 в степени -m). Пример: