Руководство по настройке формата чисел

Руководство по настройке формата чисел

В конфигурационном файле плагина (config.yml) вы можете указать формат вывода чисел с плавающей точкой. В этом разделе описаны доступные форматы и как их использовать.

Пример формата в конфиге

number-format: "%.2f"

Доступные форматы

Ниже приведены популярные форматы для чисел с плавающей точкой, которые вы можете использовать. Каждый формат задаётся с помощью спецификатора, совместимого с методом String.format() в Java.

Формат
Описание
Пример (для числа 1234.5678)

%f

Число с плавающей точкой, 6 знаков по умолчанию

1234.567800

%.0f

Целое число (без знаков после запятой)

1235

%.1f

1 знак после запятой

1234.6

%.2f

2 знака после запятой

1234.57

%.3f

3 знака после запятой

1234.568

%,.0f

Целое число с разделителями тысяч

1,235

%,.1f

1 знак после запятой, с разделителями тысяч

1,234.6

%,.2f

2 знака после запятой, с разделителями тысяч

1,234.57

%e

Научная нотация

1.234568e+03

%.1e

Научная нотация с 1 знаком

1.2e+03

%.2e

Научная нотация с 2 знаками

1.23e+03

%g

Автоматический выбор между %f и %e

1234.57 или 1.23e+03

%+.0f

Целое число с обязательным знаком (+/-)

+1235

%+.2f

Число с 2 знаками и обязательным знаком (+/-)

+1234.57

%10.2f

2 знака, ширина 10 символов (выравнивание)

1234.57

%010.2f

2 знака, ширина 10 символов, заполнение нулями

0001234.57

Объяснение:

  • %f: Обычный формат числа с плавающей точкой. По умолчанию выводит 6 знаков после запятой.

  • .0: Убирает дробную часть, округляя до целого числа.

  • .1 или .2: Указывает количество знаков после запятой (1 или 2 соответственно).

  • ,: Добавляет разделители тысяч (зависит от локали системы, например, запятые в en_US или пробелы в ru_RU).

  • %e: Научная нотация, полезна для очень больших или малых чисел.

  • %g: Автоматически выбирает между обычным и научным форматом в зависимости от числа.

  • %+f: Всегда показывает знак числа (+ или -).

  • %10.2f: Занимает минимум 10 символов, добавляя пробелы слева для выравнивания.

  • %010.2f: Как %10.2f, но заполняет нули вместо пробелов.

Дополнительные ресурсы

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

PreviousКонфиг педметовNextПлейсхолдеры

Last updated