Класс NumberFormat

java.lang.Object

java.text.Format

java.text.NumberFormat

Все реализованные интерфейсы:: Serializable, Cloneable

Прямые известные подклассы:: ChoiceFormat, CompactNumberFormat, DecimalFormat

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" (переопределение региона) расширения Unicode, десятичные цифры и/или страна, используемые для форматирования, переопределяются. Если указаны как "nu", так и "rg", десятичные цифры из расширения "nu" переопределяют неявные из расширения "rg".

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


 myNumber = nf.parse(myString);

Используйте getInstance или getNumberInstance для получения стандартного числового формата. Используйте getIntegerInstance для получения формата целых чисел. Используйте getCurrencyInstance для получения формата валюты. Используйте getCompactNumberInstance для получения формата компактного числа для форматирования числа в более короткой форме. Например, 2000 может быть отформатирован как "2K" в US locale. Используйте getPercentInstance для получения формата для отображения процентов. С этим форматом дробь, например, 0,53, отображается как 53%.

Вы также можете управлять отображением чисел с помощью таких методов, как setMinimumFractionDigits. Если вам нужно ещё больше контроля над форматом или анализом, или вы хотите предоставить пользователям больше контроля, вы можете попытаться привести NumberFormat полученные из методов фабрики к DecimalFormat или CompactNumberFormat в зависимости от используемого метода фабрики. Это будет работать для большинства языковых сред; просто помните, что нужно поместить это в 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 для того, чтобы:

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

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

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

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

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

Требования к реализации:

Методы format(double, StringBuffer, FieldPosition), format(long, StringBuffer, FieldPosition) и parse(String, ParsePosition) могут выбросить NullPointerException, если любой из их параметров null. Подкласс может предоставить собственное реализацию и спецификацию по NullPointerException.

По умолчанию реализация предоставляет режимы округления, определенные в RoundingMode для форматирования чисел. Он использует алгоритм округления по ближайшему с чётным значением. Для изменения режима округления используйте setRoundingMode. NumberFormat возвращаемый методами статической фабрики настроен на округление чисел с плавающей точкой, используя алгоритм округления по ближайшему с чётным значением (см. RoundingMode.HALF_EVEN) для форматирования.

С:

1.1

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static class`	`NumberFormat.Field`	Определяет константы, используемые в качестве ключей атрибутов в `AttributedCharacterIterator` возвращаемом `NumberFormat.formatToCharacterIterator` и как идентификаторы полей в `FieldPosition`.
`static enum`	`NumberFormat.Style`	Стиль форматирования чисел.

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`FRACTION_FIELD`	Постоянная для поля, используемая для построения объекта FieldPosition.
`static final int`	`INTEGER_FIELD`	Постоянная для поля, используемая для построения объекта FieldPosition.

Краткое описание конструкторов

NumberFormat()

Модификатор	Конструктор	Описание
`protected`	Единственный конструктор.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Переопределяет Cloneable.
`boolean`	`equals(Object obj)`	Переопределяет equals.
`final String`	`format(double number)`	Специализация форматирования.
`abstract StringBuffer`	`format(double number, StringBuffer toAppendTo, FieldPosition pos)`	Специализация форматирования.
`final String`	`format(long number)`	Специализация форматирования.
`abstract StringBuffer`	`format(long number, StringBuffer toAppendTo, FieldPosition pos)`	Специализация форматирования.
`StringBuffer`	`format(Object number, StringBuffer toAppendTo, FieldPosition pos)`	Форматирует число и добавляет полученный текст в заданный буфер строк.
`static Locale[]`	`getAvailableLocales()`	Возвращает массив всех языковых сред, для которых методы `get*Instance` этого класса могут возвращать локализованные экземпляры.
`static NumberFormat`	`getCompactNumberInstance()`	Возвращает компактный формат чисел для локале по умолчанию `FORMAT` со стилем форматирования `"SHORT"`.
`static NumberFormat`	`getCompactNumberInstance(Locale locale, NumberFormat.Style formatStyle)`	Возвращает компактный формат чисел для указанной `locale` и `formatStyle`.
`Currency`	`getCurrency()`	Получает валюту, используемую этим форматом чисел при форматировании значений валюты.
`static final NumberFormat`	`getCurrencyInstance()`	Возвращает формат валюты для текущей локале по умолчанию `FORMAT`.
`static NumberFormat`	`getCurrencyInstance(Locale inLocale)`	Возвращает формат валюты для указанной локале.
`static final NumberFormat`	`getInstance()`	Возвращает числовой формат общего назначения для текущей локале по умолчанию `FORMAT`.
`static NumberFormat`	`getInstance(Locale inLocale)`	Возвращает числовой формат общего назначения для указанной локале.
`static final NumberFormat`	`getIntegerInstance()`	Возвращает целочисленный числовой формат для текущей локале по умолчанию `FORMAT`.
`static NumberFormat`	`getIntegerInstance(Locale inLocale)`	Возвращает целочисленный числовой формат для указанной локале.
`int`	`getMaximumFractionDigits()`	Возвращает максимальное количество цифр, разрешённых в дробной части числа.
`int`	`getMaximumIntegerDigits()`	Возвращает максимальное количество цифр, разрешённых в целой части числа.
`int`	`getMinimumFractionDigits()`	Возвращает минимальное количество цифр, разрешённых в дробной части числа.
`int`	`getMinimumIntegerDigits()`	Возвращает минимальное количество цифр, разрешённых в целой части числа.
`static final NumberFormat`	`getNumberInstance()`	Возвращает числовой формат общего назначения для текущей локале по умолчанию `FORMAT`.
`static NumberFormat`	`getNumberInstance(Locale inLocale)`	Возвращает числовой формат общего назначения для указанной локале.
`static final NumberFormat`	`getPercentInstance()`	Возвращает формат процентов для текущей локале по умолчанию `FORMAT`.
`static NumberFormat`	`getPercentInstance(Locale inLocale)`	Возвращает формат процентов для указанной локале.
`RoundingMode`	`getRoundingMode()`	Получает `RoundingMode`, используемый в этом NumberFormat.
`int`	`hashCode()`	Переопределяет hashCode.
`boolean`	`isGroupingUsed()`	Возвращает true, если в этом формате используется группировка.
`boolean`	`isParseIntegerOnly()`	Возвращает true, если этот формат будет анализировать числа только как целые.
`Number`	`parse(String source)`	Анализирует текст с начала заданной строки, чтобы получить число.
`abstract Number`	`parse(String source, ParsePosition parsePosition)`	Возвращает Long, если это возможно (например, в диапазоне [Long.MIN_VALUE, Long.MAX_VALUE] и без десятичных знаков), в противном случае Double.
`final Object`	`parseObject(String source, ParsePosition pos)`	Анализирует текст из строки, чтобы получить `Number`.
`void`	`setCurrency(Currency currency)`	Устанавливает валюту, используемую этим форматом чисел при форматировании значений валюты.
`void`	`setGroupingUsed(boolean newValue)`	Устанавливает, будет ли использоваться группировка в этом формате.
`void`	`setMaximumFractionDigits(int newValue)`	Устанавливает максимальное количество цифр, разрешённых в дробной части числа. maximumFractionDigits должно быть ≥ minimumFractionDigits.
`void`	`setMaximumIntegerDigits(int newValue)`	Устанавливает максимальное количество цифр, разрешённых в целой части числа. maximumIntegerDigits должно быть ≥ minimumIntegerDigits.
`void`	`setMinimumFractionDigits(int newValue)`	Устанавливает минимальное количество цифр, разрешённых в дробной части числа. minimumFractionDigits должно быть ≤ maximumFractionDigits.
`void`	`setMinimumIntegerDigits(int newValue)`	Устанавливает минимальное количество цифр, разрешённых в целой части числа. minimumIntegerDigits должно быть ≤ maximumIntegerDigits.
`void`	`setParseIntegerOnly(boolean value)`	Устанавливает, должны ли числа анализироваться только как целые.
`void`	`setRoundingMode(RoundingMode roundingMode)`	Устанавливает `RoundingMode`, используемый в этом NumberFormat.

Методы, объявленные в классе java.text.Format

format, formatToCharacterIterator, parseObject

Методы, объявленные в классе java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

INTEGER_FIELD

public static final int INTEGER_FIELD

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

См. также:

FRACTION_FIELD

public static final int FRACTION_FIELD

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

См. также:

Подробное описание конструкторов

NumberFormat

protected NumberFormat()

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

Подробное описание методов

format

public StringBuffer format(Object number, StringBuffer toAppendTo, FieldPosition pos)

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

Эта реализация извлекает значение числа с помощью Number.longValue() для всех целочисленных значений, которые могут быть преобразованы в long без потери информации, включая BigInteger значения с bit length менее 64, и Number.doubleValue() для всех других типов. Затем она вызывает format(long,java.lang.StringBuffer,java.text.FieldPosition) или format(double,java.lang.StringBuffer,java.text.FieldPosition). Это может привести к потере информации о величине и точности для BigInteger и BigDecimal значений.

Унаследованно от:

format в классе Format

Параметры:

number - число для форматирования

toAppendTo - буфер строк, в который будет добавлен форматированный текст

pos - отслеживает позицию поля в возвращаемой строке. Например, для форматирования числа 1234567.89 в Locale.US локали, если заданное fieldPosition равно INTEGER_FIELD, начальный и конечный индексы fieldPosition будут установлены соответственно в 0 и 9 для возвращаемой строки 1,234,567.89.

Возвращает:

переданное значение в качестве toAppendTo

Исключения:

IllegalArgumentException - если number равно null или не является экземпляром Number.

NullPointerException - если toAppendTo или pos равно null

ArithmeticException - если округление необходимо, а режим округления установлен в RoundingMode.UNNECESSARY

См. также:

FieldPosition

parseObject

public final Object parseObject(String source, ParsePosition pos)

Разбирает текст из строки, чтобы получить Number.

Метод пытается разобрать текст, начиная с индекса, заданного pos. Если разбор успешен, то индекс pos обновляется до индекса после последнего используемого символа (разбор не обязательно использует все символы до конца строки), и возвращается разобранное число. Обновлённый pos может быть использован для указания начальной точки для следующего вызова этого метода. Если возникает ошибка, индекс pos не изменяется, индекс ошибки pos устанавливается в индекс символа, где произошла ошибка, и возвращается null.

См. метод parse(String, ParsePosition) для получения дополнительной информации о разборе чисел.

Унаследованно от:: parseObject в классе Format
Параметры:: source - Строка, часть которой должна быть разобрана.; pos - Объект ParsePosition с информацией об индексе и индексе ошибки, как описано выше.
Возвращает:: Число, разобранное из строки. В случае ошибки возвращает null.
Исключения:: NullPointerException - если source или pos равно null.

format

public final String format(double number)

Специализация format.

Параметры:

number - Двойное число для форматирования

Возвращает:

Форматированная строка

Исключения:

ArithmeticException - если округление необходимо, а режим округления установлен в RoundingMode.UNNECESSARY

См. также:

Format.format(java.lang.Object)

format

public final String format(long number)

Специализация format.

Параметры:

number - Длинное целое число для форматирования

Возвращает:

Форматированная строка

Исключения:

ArithmeticException - если округление необходимо, а режим округления установлен в RoundingMode.UNNECESSARY

См. также:

Format.format(java.lang.Object)

format

public abstract StringBuffer format(double number, StringBuffer toAppendTo, FieldPosition pos)

Специализация format.

Параметры:

number - Двойное число для форматирования

toAppendTo - StringBuffer, в который будет добавлен форматированный текст

Возвращает:

Форматированный StringBuffer

Исключения:

ArithmeticException - если округление необходимо, а режим округления установлен в RoundingMode.UNNECESSARY

См. также:

Format.format(java.lang.Object)

format

public abstract StringBuffer format(long number, StringBuffer toAppendTo, FieldPosition pos)

Специализация format.

Параметры:

number - Длинное целое число для форматирования

toAppendTo - StringBuffer, в который будет добавлен форматированный текст

pos - отслеживает позицию поля в возвращаемой строке. Например, для форматирования числа 123456789 в Locale.US локали, если заданное fieldPosition равно INTEGER_FIELD, начальный и конечный индексы fieldPosition будут установлены соответственно в 0 и 11 для возвращаемой строки 123,456,789.

Возвращает:

Форматированный StringBuffer

Исключения:

ArithmeticException - если округление необходимо, а режим округления установлен в RoundingMode.UNNECESSARY

См. также:

Format.format(java.lang.Object)

parse

public abstract Number parse(String source, ParsePosition parsePosition)

Возвращает Long, если это возможно (например, в диапазоне [Long.MIN_VALUE, Long.MAX_VALUE] и без десятичных знаков), в противном случае Double. Если IntegerOnly установлен, останавливается на десятичной точке (или эквиваленте; например, для рациональных чисел "1 2/3", останавливается после 1). Не выбрасывает исключение; если ни один объект не может быть разобран, индекс не изменяется!

Параметры:

source - Строка для разбора

parsePosition - Позиция разбора

Возвращает:

Разобранное значение

См. также:

parse

public Number parse(String source) throws ParseException

Разбирает текст с начала заданной строки, чтобы получить число. Метод может не использовать весь текст заданной строки.

См. метод parse(String, ParsePosition) для получения дополнительной информации о разборе чисел.

Параметры:: source - Строка, начало которой должно быть разобрано.
Возвращает:: Число, разобранное из строки.
Исключения:: ParseException - если начало заданной строки нельзя разобрать.

isParseIntegerOnly

public boolean isParseIntegerOnly()

Возвращает true, если этот формат будет разбирать числа только как целые. Например, в английской локали, с ParseIntegerOnly true, строка "1234." будет разобрана как целое значение 1234, а разбор остановится на символе ".". Конечно, точный формат, принимаемый операцией разбора, зависит от локали и определяется подклассами NumberFormat.

Возвращает:: true если числа должны быть разобраны только как целые; false в противном случае

setParseIntegerOnly

public void setParseIntegerOnly(boolean value)

Устанавливает, должны ли числа парситься только как целые.

Параметры:

value - true если числа должны парситься только как целые; false в противном случае

См. также:

isParseIntegerOnly()

getInstance

public static final NumberFormat getInstance()

Возвращает числовой формат общего назначения для текущего значения по умолчанию FORMAT локали. Это то же самое, что вызов getNumberInstance().

Возвращает:: экземпляр NumberFormat для форматирования чисел общего назначения

getInstance

public static NumberFormat getInstance(Locale inLocale)

Возвращает числовой формат общего назначения для указанной локали. Это то же самое, что вызов getNumberInstance(inLocale).

Параметры:: inLocale - желаемая локаль
Возвращает:: экземпляр NumberFormat для форматирования чисел общего назначения

getNumberInstance

public static final NumberFormat getNumberInstance()

Возвращает числовой формат общего назначения для текущего значения по умолчанию FORMAT локали.

Это эквивалентно вызову getNumberInstance(Locale.getDefault(Locale.Category.FORMAT)).

Возвращает:

экземпляр NumberFormat для форматирования чисел общего назначения

См. также:

getNumberInstance

public static NumberFormat getNumberInstance(Locale inLocale)

Возвращает числовой формат общего назначения для указанной локали.

Параметры:: inLocale - желаемая локаль
Возвращает:: экземпляр NumberFormat для форматирования чисел общего назначения

getIntegerInstance

public static final NumberFormat getIntegerInstance()

Возвращает числовой формат целых чисел для текущей локали по умолчанию FORMAT. Возвращаемый числовой формат настроен на округление чисел с плавающей точкой до ближайшего целого с использованием округления по методу половина-к-ближайшему (см. RoundingMode.HALF_EVEN) для форматирования и для парсинга только целой части входной строки (см. isParseIntegerOnly).

Это эквивалентно вызову getIntegerInstance(Locale.getDefault(Locale.Category.FORMAT)).

Возвращает:

числовой формат для целых значений

С:

1.4

См. также:

getIntegerInstance

public static NumberFormat getIntegerInstance(Locale inLocale)

Возвращает числовой формат целых чисел для указанной локали. Возвращаемый числовой формат настроен на округление чисел с плавающей точкой до ближайшего целого с использованием округления по методу половина-к-ближайшему (см. RoundingMode.HALF_EVEN) для форматирования и для парсинга только целой части входной строки (см. isParseIntegerOnly).

Параметры:

inLocale - желаемая локаль

Возвращает:

числовой формат для целых значений

С:

1.4

См. также:

getRoundingMode()

getCurrencyInstance

public static final NumberFormat getCurrencyInstance()

Возвращает формат валюты для текущей локали по умолчанию FORMAT.

Это эквивалентно вызову getCurrencyInstance(Locale.getDefault(Locale.Category.FORMAT)).

Возвращает:

экземпляр NumberFormat для форматирования валюты

См. также:

getCurrencyInstance

public static NumberFormat getCurrencyInstance(Locale inLocale)

Возвращает формат валюты для указанной локали.

Если указанная локаль содержит «cf» ( стиль форматирования валюты) расширение Юникода, возвращаемый формат валюты использует этот стиль, если он доступен. В противном случае стиль использует формат валюты по умолчанию «standard». Например, если стиль определяет «account», отрицательные суммы валюты в некоторых локалях используют пару скобок.

Параметры:: inLocale - желаемая локаль
Возвращает:: экземпляр NumberFormat для форматирования валюты

getPercentInstance

public static final NumberFormat getPercentInstance()

Возвращает формат процентов для текущей локали по умолчанию FORMAT.

Это эквивалентно вызову getPercentInstance(Locale.getDefault(Locale.Category.FORMAT)).

Возвращает:

экземпляр NumberFormat для форматирования процентов

См. также:

getPercentInstance

public static NumberFormat getPercentInstance(Locale inLocale)

Возвращает формат процентов для указанной локали.

Параметры:: inLocale - желаемая локаль
Возвращает:: экземпляр NumberFormat для форматирования процентов

getCompactNumberInstance

public static NumberFormat getCompactNumberInstance()

Возвращает компактный числовой формат для локали по умолчанию FORMAT со стилем форматирования "SHORT".

Возвращает:

Экземпляр NumberFormat для компактного форматирования чисел

С:

См. также:

getCompactNumberInstance

public static NumberFormat getCompactNumberInstance(Locale locale, NumberFormat.Style formatStyle)

Возвращает компактный числовой формат для указанной locale и formatStyle.

Параметры:

locale - желаемая локаль

formatStyle - стиль форматирования числа

Возвращает:

Экземпляр NumberFormat для компактного форматирования чисел

Исключения:

NullPointerException - если locale или formatStyle имеет значение null

С:

См. также:

getAvailableLocales

public static Locale[] getAvailableLocales()

Возвращает массив всех локалей, для которых методы get*Instance этого класса могут вернуть локализованные экземпляры. Возвращаемый массив представляет собой объединение локалей, поддерживаемых Java-средой выполнения и установленными реализациями NumberFormatProvider. Он должен содержать как минимум экземпляр Locale равный Locale.US.

Возвращает:: Массив локалей, для которых доступны локализованные экземпляры NumberFormat.

hashCode

public int hashCode()

Переопределяет hashCode.

Переопределяет:

hashCode в классе Object

Возвращает:

значение хэш-кода для этого объекта.

См. также:

equals

public boolean equals(Object obj)

Переопределяет equals.

Переопределяет:

equals в классе Object

Параметры:

obj - объект-ссылка для сравнения.

Возвращает:

true если этот объект такой же, как аргумент obj; false в противном случае.

См. также:

END_OF_DOCUMENT_MARKER

clone

public Object clone()

Переопределяет Cloneable.

Переопределяет:

clone в классе Format

Возвращает:

клонированный экземпляр.

См. также:

Cloneable

isGroupingUsed

public boolean isGroupingUsed()

Возвращает true, если в этом формате используется группировка. Например, в английском языке с включённой группировкой число 1234567 может быть отформатировано как "1 234 567". Разделитель группировки и размер каждой группы зависят от локали и определяются подклассами NumberFormat.

Возвращает:

true если используется группировка; false в противном случае

См. также:

setGroupingUsed(boolean)

setGroupingUsed

public void setGroupingUsed(boolean newValue)

Устанавливает, будет ли использоваться группировка в этом формате.

Параметры:

newValue - true если используется группировка; false в противном случае

См. также:

isGroupingUsed()

getMaximumIntegerDigits

public int getMaximumIntegerDigits()

Возвращает максимальное количество цифр, разрешенных в целой части числа.

Возвращает:

максимальное количество цифр

См. также:

setMaximumIntegerDigits(int)

setMaximumIntegerDigits

public void setMaximumIntegerDigits(int newValue)

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

Параметры:

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

См. также:

getMaximumIntegerDigits()

getMinimumIntegerDigits

public int getMinimumIntegerDigits()

Возвращает минимальное количество цифр, разрешенных в целой части числа.

Возвращает:

минимальное количество цифр

См. также:

setMinimumIntegerDigits(int)

setMinimumIntegerDigits

public void setMinimumIntegerDigits(int newValue)

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

Параметры:

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

См. также:

getMinimumIntegerDigits()

getMaximumFractionDigits

public int getMaximumFractionDigits()

Возвращает максимальное количество цифр, разрешенных в дробной части числа.

Возвращает:

максимальное количество цифр.

См. также:

setMaximumFractionDigits(int)

setMaximumFractionDigits

public void setMaximumFractionDigits(int newValue)

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

Параметры:

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

См. также:

getMaximumFractionDigits()

getMinimumFractionDigits

public int getMinimumFractionDigits()

Возвращает минимальное количество цифр, разрешенных в дробной части числа.

Возвращает:

минимальное количество цифр

См. также:

setMinimumFractionDigits(int)

setMinimumFractionDigits

public void setMinimumFractionDigits(int newValue)

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

Параметры:

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

См. также:

getMinimumFractionDigits()

getCurrency

public Currency getCurrency()

Возвращает валюту, используемую этим форматом числа при форматировании значений валюты. Начальное значение определяется в зависимости от локали. Возвращаемое значение может быть null, если не удалось определить допустимую валюту, и если не была установлена валюта с помощью setCurrency.

В реализации по умолчанию вызывается UnsupportedOperationException.

Возвращает:: валюту, используемую этим форматом числа, или null
Исключения:: UnsupportedOperationException - если класс формата числа не реализует форматирование валюты
С момента:: 1.4

setCurrency

public void setCurrency(Currency currency)

Устанавливает валюту, используемую этим форматом числа при форматировании значений валюты. Это не обновляет минимальное или максимальное количество знаков после запятой, используемых форматом числа.

В реализации по умолчанию вызывается UnsupportedOperationException.

Параметры:: currency - новая валюта, используемая этим форматом числа
Исключения:: UnsupportedOperationException - если класс формата числа не реализует форматирование валюты; NullPointerException - если currency равно null
С момента:: 1.4

getRoundingMode

public RoundingMode getRoundingMode()

Возвращает RoundingMode используемое в этом NumberFormat. В реализации по умолчанию этого метода в NumberFormat всегда выбрасывается UnsupportedOperationException. Подклассы, которые обрабатывают различные режимы округления, должны переопределять этот метод.

Возвращает:

Используемое в NumberFormat RoundingMode.

Исключения:

UnsupportedOperationException - Реализация по умолчанию всегда выбрасывает это исключение

С момента:

1.6

См. также:

setRoundingMode(RoundingMode)

setRoundingMode

public void setRoundingMode(RoundingMode roundingMode)

Устанавливает RoundingMode, используемое в этом NumberFormat. В реализации по умолчанию этого метода в NumberFormat всегда выбрасывается UnsupportedOperationException. Подклассы, которые обрабатывают различные режимы округления, должны переопределять этот метод.

Параметры:

roundingMode - Используемый RoundingMode

Исключения:

UnsupportedOperationException - Реализация по умолчанию всегда выбрасывает это исключение

NullPointerException - если roundingMode равно null

С момента:

1.6

См. также:

getRoundingMode()

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/text/NumberFormat.html