Класс NumberFormat

public abstract class NumberFormat
extends Format

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

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

Для форматирования числа для текущей локали используйте один из методов фабричного класса:

myString = NumberFormat.getInstance().format(myNumber);

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

NumberFormat nf = NumberFormat.getInstance();
for (int i = 0; i < myNumber.length; ++i) {
    output.println(nf.format(myNumber[i]) + "; ");
}

Для форматирования числа для другой локали укажите её в вызове getInstance.

NumberFormat nf = NumberFormat.getInstance(Locale.FRENCH);

Если локаль содержит "nu" (числа) и/или "rg" (переопределение региона) расширения Юникода, десятичные цифры и/или страна, используемая для форматирования, переопределяются. Если оба "nu" и "rg" указаны, десятичные цифры из расширения "nu" переопределяют неявные цифры из расширения "rg".

Вы также можете использовать NumberFormat для разбора чисел:

myNumber = nf.parse(myString);

Используйте getInstance или getNumberInstance для получения обычного числового формата. Используйте getIntegerInstance для получения целого числового формата. Используйте getCurrencyInstance для получения числового формата валюты. И используйте getPercentInstance для получения формата для отображения процентов. С этим форматом дробь, например, 0.53, отображается как 53%.

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

NumberFormat и DecimalFormat разработаны таким образом, что некоторые элементы управления работают для форматирования, а другие - для разбора. Ниже приведено подробное описание каждого из этих методов управления.

setParseIntegerOnly : влияет только на разбор, например, если true, "3456.78" → 3456 (и оставляет позицию разбора сразу после индекса 6), если false, "3456.78" → 3456.78 (и оставляет позицию разбора сразу после индекса 8). Это независимо от форматирования. Если вы хотите не отображать десятичную точку, где может не быть цифр после десятичной точки, используйте setDecimalSeparatorAlwaysShown.

setDecimalSeparatorAlwaysShown : влияет только на форматирование, и только там, где может не быть цифр после десятичной точки, например, с шаблоном вроде "#,##0.##", например, если true, 3456.00 → "3,456.", если false, 3456.00 → "3456". Это независимо от разбора. Если вы хотите, чтобы разбор останавливался на десятичной точке, используйте setParseIntegerOnly.

Вы также можете использовать формы методов parse и format с ParsePosition и FieldPosition , чтобы позволить вам:

• поэтапно разбирать фрагменты строки
• выравнивать десятичную точку и другие области

Например, вы можете выровнять числа двумя способами:

1. Если вы используете моноширинный шрифт с отступами для выравнивания, вы можете передать FieldPosition в свой вызов формата, при этом field = INTEGER_FIELD. На выходе getEndIndex будет установлен в смещение между последним символом целой части и десятичной. Добавьте (desiredSpaceCount - getEndIndex) пробелов в начало строки.
2. Если вы используете пропорциональные шрифты, вместо заполнения пробелами, измерьте ширину строки в пикселях от начала до getEndIndex. Затем перед рисованием текста сместите перо на (desiredPixelWidth - widthToAlignmentPoint). Это также работает, когда нет десятичной точки, но, возможно, есть дополнительные символы в конце, например, с скобками в отрицательных числах: "(12)" для -12.

Синхронизация

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