java.text

Класс DecimalFormat

java.lang. Объект

java.text. Формат

java.text. NumberFormat

java.text. DecimalFormat

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable

public class DecimalFormat
extends NumberFormat

DecimalFormat конкретный подкласс NumberFormat это форматирует десятичные числа. У этого есть множество функций, разработанных, чтобы позволить проанализировать и отформатировать числа в любой локали, включая поддержку Западных, арабских, и Относящихся к Индии цифр. Это также поддерживает различные виды чисел, включая целые числа (123), числа фиксированной точки (123.4), экспоненциальное представление (1.23E4), проценты (12 %), и количество валюты (123$). Все они могут быть локализованы.

Получить a NumberFormat для определенной локали, включая локаль по умолчанию, вызов один из NumberFormat's методы фабрики, такой как getInstance(). Вообще, не вызывайте DecimalFormat конструкторы непосредственно, начиная с NumberFormat методы фабрики могут возвратить подклассы кроме DecimalFormat. Если Вы должны настроить объект формата, сделайте что-то вроде этого:

 NumberFormat f = NumberFormat.getInstance(loc);
 if (f instanceof DecimalFormat) {
     ((DecimalFormat) f).setDecimalSeparatorAlwaysShown(true);
 }
 

A DecimalFormat включает образец и ряд символов. Образец может быть установлен, непосредственно используя applyPattern(), или косвенно используя методы API. Символы сохранены в a DecimalFormatSymbols объект. При использовании NumberFormat методы фабрики, образец и символы читаются из локализованного ResourceBundles.

Образцы

DecimalFormat у образцов есть следующий синтаксис:

 Pattern:
         PositivePattern
         PositivePattern ; NegativePattern
 PositivePattern:
         Prefixopt Number Suffixopt
 NegativePattern:
         Prefixopt Number Suffixopt
 Prefix:
         any Unicode characters except \uFFFE, \uFFFF, and special characters
 Suffix:
         any Unicode characters except \uFFFE, \uFFFF, and special characters
 Number:
         Integer Exponentopt
         Integer . Fraction Exponentopt
 Integer:
         MinimumInteger
         #
         # Integer
         # , Integer
 MinimumInteger:
         0
         0 MinimumInteger
         0 , MinimumInteger
 Fraction:
         MinimumFractionopt OptionalFractionopt
 MinimumFraction:
         0 MinimumFractionopt
 OptionalFraction:
         # OptionalFractionopt
 Exponent:
         E MinimumExponent
 MinimumExponent:
         0 MinimumExponentopt
 

A DecimalFormat образец содержит положительный и отрицательный подобразец, например, "#,##0.00;(#,##0.00)". У каждого подобразца есть префикс, числовая часть, и суффикс. Отрицательный подобразец является дополнительным; если отсутствующий, то положительный подобразец, снабженный префиксом локализованный знак "минус" ('-' в большинстве локалей), используется в качестве отрицательного подобразца. Таким образом, "0.00" один эквивалентно "0.00;-0.00". Если есть явный отрицательный подобразец, он служит только, чтобы определить отрицательный префикс и суффикс; число цифр, минимальных цифр, и других характеристик является всем одинаковым как положительный образец. Это означает это "#,##0.0#;(#)" производит точно то же самое поведение как "#,##0.0#;(#,##0.0#)".

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

Группирующийся разделитель обычно используется для тысяч, но в некоторых странах он разделяет десять тысяч. Группирующийся размер является постоянным числом цифр между группирующимися символами, такой как 3 для 100 000 000 или 4 для 1,0000,0000. Если Вы предоставляете образец многократные символы группировки, интервал между последним и концом целого числа является тем, который используется. Так "#,##,###,####" == "######,####" == "##,####,####".

Специальные Символы Образца

Много символов в образце берутся буквально; они являются соответствующими во время парсинга и выводятся неизменные во время форматирования. Специальные символы, с другой стороны, обозначают другие символы, строки, или классы символов. Они должны быть заключены в кавычки, если не отмечено иначе, если они должны появиться в префиксе или суффиксе как литералы.

Символы, перечисленные здесь, используются в нелокализованных образцах. Локализованные образцы используют соответствующие символы, взятые от этого средства форматирования DecimalFormatSymbols объект вместо этого, и эти символы теряют их особый статус. Два исключения являются знаком валюты и кавычкой, которые не локализуются.

Символ	Расположение	Локализованный?	Значение
0	Число	Да	Цифра
#	Число	Да	Цифра, нуль показывает как отсутствующий
.	Число	Да	Десятичный разделитель или денежно-кредитный десятичный разделитель
-	Число	Да	Знак "минус"
,	Число	Да	Группировка разделителя
E	Число	Да	Разделяет мантиссу и экспоненту в экспоненциальном представлении. Не должен быть заключен в кавычки в префиксе или суффиксе.
;	Граница подобразца	Да	Разделяет положительные и отрицательные подобразцы
%	Префикс или суффикс	Да	Умножьтесь на 100 и шоу как процент
\u2030	Префикс или суффикс	Да	Умножьтесь на 1000 и покажите согласно значению mille
¤ (\u00A4)	Префикс или суффикс	Нет	Знак валюты, замененный обозначением денежной единицы. Если удвоено, замененный международным обозначением денежной единицы. Если существующий в образце, денежно-кредитный десятичный разделитель используется вместо десятичного разделителя.
'	Префикс или суффикс	Нет	Используемый, чтобы заключить специальные символы в кавычки в префиксе или суффиксе, например, "'#'#" форматы 123 к "#123". Чтобы создать одинарную кавычку непосредственно, используйте два подряд: "# o''clock".

Экспоненциальное представление

Числа в экспоненциальном представлении выражаются как продукт мантиссы, и питание десять, например, 1234 может быть выражен как 1.234 x 10^3. Мантисса часто находится в диапазоне 1.0 <= x < 10.0, but it need not be. DecimalFormat может быть проинструктирован, чтобы отформатировать и проанализировать экспоненциальное представление только через образец; нет в настоящий момент никакого метода фабрики, который создает формат экспоненциального представления. В образце символ экспоненты, сразу сопровождаемый одним или более символами цифры, указывает на экспоненциальное представление. Пример: "0.###E0" форматирует номер 1234 как "1.234E3".

• Число символов цифры после символа экспоненты дает минимальное количество цифры экспоненты. Нет никакого максимума. Отрицательные экспоненты форматируются, используя локализованный знак "минус", не префикс и суффикс от образца. Это позволяет образцы такой как "0.###E0 m/s".
• Минимальное и максимальное количество целочисленных цифр интерпретируется вместе:
  • Если максимальное количество целочисленных цифр больше чем их минимальное число и больше чем 1, это вынуждает экспоненту быть кратным числом максимального количества целочисленных цифр, и минимального числа целочисленных цифр, которые будут интерпретироваться как 1. Наиболее популярный способ использования этого должен генерировать техническую нотацию, в которой экспонента является кратным числом три, например, "##0.#####E0". Используя этот образец, номер 12345 форматирует к "12.345E3", и 123456 форматов к "123.456E3".
  • Иначе, минимальное число целочисленных цифр достигается, корректируя экспоненту. Пример: 0.00123 отформатированный с "00.###E0" урожаи "12.3E-4".
• Число существенных цифр в мантиссе является суммой минимальных целочисленных и максимальных дробных цифр, и незатронуто максимальными целочисленными цифрами. Например, 12345 отформатированный с "##0.##E0" "12.3E3". Чтобы показать все цифры, обнулите существенное количество цифр. Число существенных цифр не влияет на парсинг.
• Экспоненциальные образцы, возможно, не содержат группирующиеся разделители.

Округление

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

Цифры

Для того, чтобы отформатировать, DecimalFormat использует десять последовательных символов, запускающихся с локализованной нулевой цифры, определенной в DecimalFormatSymbols возразите как цифры. Для того, чтобы проанализировать, эти цифры так же как все десятичные цифры Unicode, как определено Character.digit, распознаются.

Специальные Значения

NaN форматируется как строка, у которой обычно есть единственный символ \uFFFD. Эта строка определяется DecimalFormatSymbols объект. Это - единственное значение, для которого не используются префиксы и суффиксы.

Бесконечность форматируется как строка, у которой обычно есть единственный символ \u221E, с положительными или отрицательными префиксами и суффиксами применялся. Строка бесконечности определяется DecimalFormatSymbols объект.

Отрицательный нуль ("-0") синтаксические анализы к

• BigDecimal(0) если isParseBigDecimal() истина,
• Long(0) если isParseBigDecimal() ложь и isParseIntegerOnly() истина,
• Double(-0.0) если оба isParseBigDecimal() и isParseIntegerOnly() ложь.

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

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

Пример

 // Print out a number using the localized number, integer, currency,
 // and percent format for each locale
 Locale[] locales = NumberFormat.getAvailableLocales();
 double myNumber = -1234.56;
 NumberFormat form;
 for (int j=0; j<4; ++j) {
     System.out.println("FORMAT");
     for (int i = 0; i < locales.length; ++i) {
         if (locales[i].getCountry().length() == 0) {
            continue; // Skip language-only locales
         }
         System.out.print(locales[i].getDisplayName());
         switch (j) {
         case 0:
             form = NumberFormat.getInstance(locales[i]); break;
         case 1:
             form = NumberFormat.getIntegerInstance(locales[i]); break;
         case 2:
             form = NumberFormat.getCurrencyInstance(locales[i]); break;
         default:
             form = NumberFormat.getPercentInstance(locales[i]); break;
         }
         if (form instanceof DecimalFormat) {
             System.out.print(": " + ((DecimalFormat) form).toPattern());
         }
         System.out.print(" -> " + form.format(myNumber));
         try {
             System.out.println(" -> " + form.parse(form.format(myNumber)));
         } catch (ParseException e) {}
     }
 }
 

См. Также:

Учебное руководство по Java, NumberFormat, DecimalFormatSymbols, ParsePosition, Сериализированная Форма

Вложенная Сводка Класса

Вложенные классы/интерфейсы java.text унаследованный от класса. NumberFormat

NumberFormat. Поле

Полевая Сводка

Поля java.text унаследованный от класса. NumberFormat

FRACTION_FIELD, INTEGER_FIELD

Сводка конструктора

Конструкторы

Конструктор и Описание
DecimalFormat() Создает DecimalFormat, используя образец по умолчанию и символы для локали по умолчанию.
DecimalFormat(String pattern) Создает DecimalFormat, используя данный образец и символы для локали по умолчанию.
DecimalFormat(String pattern, DecimalFormatSymbols symbols) Создает DecimalFormat, используя данный образец и символы.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	applyLocalizedPattern(String pattern) Примените данный образец к этому объекту Формата.
void	applyPattern(String pattern) Примените данный образец к этому объекту Формата.
Объект	clone() Стандартное переопределение; никакое изменение в семантике.
boolean	equals(Object obj) Переопределения равняются
StringBuffer	format(double number, StringBuffer result, FieldPosition fieldPosition) Форматы a удваиваются, чтобы произвести строку.
StringBuffer	format(long number, StringBuffer result, FieldPosition fieldPosition) Отформатируйте длинное, чтобы произвести строку.
StringBuffer	format(Object number, StringBuffer toAppendTo, FieldPosition pos) Форматирует число и добавляет получающийся текст к данному строковому буферу.
AttributedCharacterIterator	formatToCharacterIterator(Object obj) Форматирует Объект, производящий AttributedCharacterIterator.
Валюта	getCurrency() Использовали валюту этим десятичным форматом, форматируя значения валюты.
DecimalFormatSymbols	getDecimalFormatSymbols() Возвращает копию десятичных символов формата, которая обычно не изменяется программистом или пользователем.
int	getGroupingSize() Возвратите группирующийся размер.
int	getMaximumFractionDigits() Получает максимальное количество цифр, позволенных в дробной части числа.
int	getMaximumIntegerDigits() Получает максимальное количество цифр, позволенных в целочисленной части числа.
int	getMinimumFractionDigits() Получает минимальное число цифр, позволенных в дробной части числа.
int	getMinimumIntegerDigits() Получает минимальное число цифр, позволенных в целочисленной части числа.
int	getMultiplier() Получает множитель для использования в проценте, промилле, и подобные форматы.
Строка	getNegativePrefix() Получите отрицательный префикс.
Строка	getNegativeSuffix() Получите отрицательный суффикс.
Строка	getPositivePrefix() Получите положительный префикс.
Строка	getPositiveSuffix() Получите положительный суффикс.
RoundingMode	getRoundingMode() Добирается RoundingMode используемый в этом DecimalFormat.
int	hashCode() Хэш-код переопределений
boolean	isDecimalSeparatorAlwaysShown() Позволяет Вам получать поведение десятичного разделителя с целыми числами.
boolean	isParseBigDecimal() Возвраты, ли parse(java.lang.String, java.text.ParsePosition) возвраты метода BigDecimal.
Число	parse(String text, ParsePosition pos) Текст синтаксических анализов от строки, чтобы произвести a Number.
void	setCurrency(Currency currency) Устанавливает валюту, используемую этим числовым форматом, форматируя значения валюты.
void	setDecimalFormatSymbols(DecimalFormatSymbols newSymbols) Устанавливает десятичные символы формата, который обычно не изменяется программистом или пользователем.
void	setDecimalSeparatorAlwaysShown(boolean newValue) Позволяет Вам устанавливать поведение десятичного разделителя с целыми числами.
void	setGroupingSize(int newValue) Установите группирующийся размер.
void	setMaximumFractionDigits(int newValue) Устанавливает максимальное количество цифр, позволенных в дробной части числа.
void	setMaximumIntegerDigits(int newValue) Устанавливает максимальное количество цифр, позволенных в целочисленной части числа.
void	setMinimumFractionDigits(int newValue) Определяет минимальный номер цифр, позволенных в дробной части числа.
void	setMinimumIntegerDigits(int newValue) Определяет минимальный номер цифр, позволенных в целочисленной части числа.
void	setMultiplier(int newValue) Устанавливает множитель для использования в проценте, промилле, и подобные форматы.
void	setNegativePrefix(String newValue) Установите отрицательный префикс.
void	setNegativeSuffix(String newValue) Установите отрицательный суффикс.
void	setParseBigDecimal(boolean newValue) Наборы, ли parse(java.lang.String, java.text.ParsePosition) возвраты метода BigDecimal.
void	setPositivePrefix(String newValue) Установите положительный префикс.
void	setPositiveSuffix(String newValue) Установите положительный суффикс.
void	setRoundingMode(RoundingMode roundingMode) Наборы RoundingMode используемый в этом DecimalFormat.
Строка	toLocalizedPattern() Синтезирует локализованную строку образца, которая представляет текущее состояние этого объекта Формата.
Строка	toPattern() Синтезирует строку образца, которая представляет текущее состояние этого объекта Формата.

Методы java.text унаследованный от класса. NumberFormat

format, format, getAvailableLocales, getCurrencyInstance, getCurrencyInstance, getInstance, getInstance, getIntegerInstance, getIntegerInstance, getNumberInstance, getNumberInstance, getPercentInstance, getPercentInstance, isGroupingUsed, isParseIntegerOnly, parse, parseObject, setGroupingUsed, setParseIntegerOnly

Методы java.text унаследованный от класса. Формат

format, parseObject

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

DecimalFormat

public DecimalFormat()

Создает DecimalFormat, используя образец по умолчанию и символы для локали по умолчанию. Это - удобный способ получить DecimalFormat, когда интернационализация не является основным беспокойством.

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

См. Также:

NumberFormat.getInstance(), NumberFormat.getNumberInstance(), NumberFormat.getCurrencyInstance(), NumberFormat.getPercentInstance()

DecimalFormat

public DecimalFormat(String pattern)

Создает DecimalFormat, используя данный образец и символы для локали по умолчанию. Это - удобный способ получить DecimalFormat, когда интернационализация не является основным беспокойством.

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

Параметры:

pattern - Нелокализованная строка образца.

Броски:

NullPointerException - если pattern нуль

IllegalArgumentException - если данный образец недопустим.

См. Также:

NumberFormat.getInstance(), NumberFormat.getNumberInstance(), NumberFormat.getCurrencyInstance(), NumberFormat.getPercentInstance()

DecimalFormat

public DecimalFormat(String pattern,
             DecimalFormatSymbols symbols)

Создает DecimalFormat, используя данный образец и символы. Используйте этого конструктора, когда Вы должны полностью настроить поведение формата.

Чтобы получить стандартные форматы для данной локали, используйте методы фабрики на NumberFormat, такие как getInstance или getCurrencyInstance. Если Вы нуждаетесь только в незначительных корректировках стандартного формата, можно изменить формат, возвращенный методом фабрики NumberFormat.

Параметры:

pattern - нелокализованная строка образца

symbols - набор символов, которые будут использоваться

Броски:

NullPointerException - если каким-либо из данных параметров является нуль

IllegalArgumentException - если данный образец недопустим

См. Также:

NumberFormat.getInstance(), NumberFormat.getNumberInstance(), NumberFormat.getCurrencyInstance(), NumberFormat.getPercentInstance(), DecimalFormatSymbols

Деталь метода

формат

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

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

Эта реализация использует максимальную разрешенную точность.

Переопределения:

format в классе NumberFormat

Параметры:

number - число, чтобы отформатировать

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

pos - На вводе: поле выравнивания, при желании. На выводе: смещения поля выравнивания.

Возвраты:

значение, в котором передают как toAppendTo

Броски:

IllegalArgumentException - если number нуль или не экземпляр Number.

NullPointerException - если toAppendTo или pos нуль

ArithmeticException - если округление необходимо с округлением режима, устанавливаемого в RoundingMode. НЕНУЖНЫЙ

См. Также:

FieldPosition

формат

public StringBuffer format(double number,
                  StringBuffer result,
                  FieldPosition fieldPosition)

Форматы a удваиваются, чтобы произвести строку.

Определенный:

format в классе NumberFormat

Параметры:

number - Вдвое большее по сравнению с форматом

result - где текст должен быть добавлен

fieldPosition - На вводе: поле выравнивания, при желании. На выводе: смещения поля выравнивания.

Возвраты:

Отформатированная строка числа

Броски:

ArithmeticException - если округление необходимо с округлением режима, устанавливаемого в RoundingMode. НЕНУЖНЫЙ

См. Также:

FieldPosition

формат

public StringBuffer format(long number,
                  StringBuffer result,
                  FieldPosition fieldPosition)

Отформатируйте длинное, чтобы произвести строку.

Определенный:

format в классе NumberFormat

Параметры:

number - Длинное, чтобы отформатировать

result - где текст должен быть добавлен

fieldPosition - На вводе: поле выравнивания, при желании. На выводе: смещения поля выравнивания.

Возвраты:

Отформатированная строка числа

Броски:

ArithmeticException - если округление необходимо с округлением режима, устанавливаемого в RoundingMode. НЕНУЖНЫЙ

См. Также:

FieldPosition

formatToCharacterIterator

public AttributedCharacterIterator formatToCharacterIterator(Object obj)

Форматирует Объект, производящий AttributedCharacterIterator. Можно использовать возвращенный AttributedCharacterIterator создать получающуюся Строку, так же как определить информацию о получающейся Строке.

Каждый ключ атрибута AttributedCharacterIterator будет иметь тип NumberFormat.Field, со значением атрибута, являющимся тем же самым как ключ атрибута.

Переопределения:

formatToCharacterIterator в классе Format

Параметры:

obj - Объект отформатировать

Возвраты:

AttributedCharacterIterator, описывающий отформатированное значение.

Броски:

NullPointerException - если obj является нулем.

IllegalArgumentException - когда Формат не может отформатировать данный объект.

ArithmeticException - если округление необходимо с округлением режима, устанавливаемого в RoundingMode. НЕНУЖНЫЙ

С тех пор:

1.4

синтаксический анализ

public Number parse(String text,
           ParsePosition pos)

Текст синтаксических анализов от строки, чтобы произвести a Number.

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

Возвращенный подкласс зависит от значения isParseBigDecimal() так же как на проанализированной строке.

• Если isParseBigDecimal() ложь (значение по умолчанию), большинство целочисленных значений возвращается как Long объекты, независимо от того как они пишутся: "17" и "17.000" оба синтаксических анализа к Long(17). Значения, которые не могут вписаться в a Long возвращаются как Doubles. Это включает значения с дробной частью, бесконечные значения, NaN, и значение-0.0. DecimalFormat не решает, возвратить ли a Double или a Long основанный на присутствии десятичного разделителя в исходной строке. Выполнение так предотвратило бы целые числа, которые переполняют мантиссы двойного, такой как "-9,223,372,036,854,775,808.00", от того, чтобы быть проанализированным точно.

  Вызывающие стороны могут использовать Number методы doubleValue, longValue, и т.д. чтобы получить тип они хотят.

• Если isParseBigDecimal() истина, значения возвращаются как BigDecimal объекты. Значения - те созданные BigDecimal.BigDecimal(String) для соответствующих строк в независимом от локали формате. Особые случаи отрицательная и положительная бесконечность и НЭН возвращаются как Double экземпляры, содержащие значения соответствия Double константы.

DecimalFormat синтаксические анализы все символы Unicode, которые представляют десятичные цифры, как определено Character.digit(). Кроме того, DecimalFormat также распознает как цифры десять последовательных символов, запускающихся с локализованной нулевой цифры, определенной в DecimalFormatSymbols объект.

Определенный:

parse в классе NumberFormat

Параметры:

text - строка, которая будет проанализирована

pos - A ParsePosition объект с индексом и ошибкой индексирует информацию как описано выше.

Возвраты:

проанализированное значение, или null если синтаксический анализ перестал работать

Броски:

NullPointerException - если text или pos нуль.

См. Также:

NumberFormat.isParseIntegerOnly(), Format.parseObject(java.lang.String, java.text.ParsePosition)

getDecimalFormatSymbols

public DecimalFormatSymbols getDecimalFormatSymbols()

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

Возвраты:

копия требуемого DecimalFormatSymbols

См. Также:

DecimalFormatSymbols

setDecimalFormatSymbols

public void setDecimalFormatSymbols(DecimalFormatSymbols newSymbols)

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

Параметры:

newSymbols - требуемый DecimalFormatSymbols

См. Также:

DecimalFormatSymbols

getPositivePrefix

public String getPositivePrefix()

Получите положительный префикс.

Примеры: +123, 123$, sFr123

setPositivePrefix

public void setPositivePrefix(String newValue)

Установите положительный префикс.

Примеры: +123, 123$, sFr123

getNegativePrefix

public String getNegativePrefix()

Получите отрицательный префикс.

Примеры:-123, (123$) (с отрицательным суффиксом), sFr-123

setNegativePrefix

public void setNegativePrefix(String newValue)

Установите отрицательный префикс.

Примеры:-123, (123$) (с отрицательным суффиксом), sFr-123

getPositiveSuffix

public String getPositiveSuffix()

Получите положительный суффикс.

Пример: 123 %

setPositiveSuffix

public void setPositiveSuffix(String newValue)

Установите положительный суффикс.

Пример: 123 %

getNegativeSuffix

public String getNegativeSuffix()

Получите отрицательный суффикс.

Примеры:-123 %, (123$) (с положительными суффиксами)

setNegativeSuffix

public void setNegativeSuffix(String newValue)

Установите отрицательный суффикс.

Примеры: 123 %

getMultiplier

public int getMultiplier()

Получает множитель для использования в проценте, промилле, и подобные форматы.

См. Также:

setMultiplier(int)

setMultiplier

public void setMultiplier(int newValue)

Устанавливает множитель для использования в проценте, промилле, и подобные форматы. Для процентного формата, набор множитель к 100 и суффиксы, чтобы иметь '%' (для арабского языка, используют арабский знак процента). Для промилле формата, устанавливает множитель в 1000 и суффиксы, чтобы иметь '\u2030'.

Пример: со множителем 100, 1.23 форматируется, поскольку "123", и "123" анализируется в 1.23.

См. Также:

getMultiplier()

getGroupingSize

public int getGroupingSize()

Возвратите группирующийся размер. Группировка размера является числом цифр между группирующимися разделителями в целочисленной части числа. Например, в числе "123 456.78", группирующийся размер 3.

См. Также:

setGroupingSize(int), NumberFormat.isGroupingUsed(), DecimalFormatSymbols.getGroupingSeparator()

setGroupingSize

public void setGroupingSize(int newValue)

Установите группирующийся размер. Группировка размера является числом цифр между группирующимися разделителями в целочисленной части числа. Например, в числе "123 456.78", группирующийся размер 3.
Значение, которое передают в, преобразовывается в байт, который может потерять информацию.

См. Также:

getGroupingSize(), NumberFormat.setGroupingUsed(boolean), DecimalFormatSymbols.setGroupingSeparator(char)

isDecimalSeparatorAlwaysShown

public boolean isDecimalSeparatorAlwaysShown()

Позволяет Вам получать поведение десятичного разделителя с целыми числами. (Десятичный разделитель будет всегда появляться с десятичными числами.)

Пример: Десятичное число НА: 12345-> 12345.; ПРОЧЬ: 12345-> 12345

setDecimalSeparatorAlwaysShown

public void setDecimalSeparatorAlwaysShown(boolean newValue)

Позволяет Вам устанавливать поведение десятичного разделителя с целыми числами. (Десятичный разделитель будет всегда появляться с десятичными числами.)

Пример: Десятичное число НА: 12345-> 12345.; ПРОЧЬ: 12345-> 12345

isParseBigDecimal

public boolean isParseBigDecimal()

Возвраты, ли parse(java.lang.String, java.text.ParsePosition) возвраты метода BigDecimal. Значение по умолчанию является ложью.

С тех пор:

1.5

См. Также:

setParseBigDecimal(boolean)

setParseBigDecimal

public void setParseBigDecimal(boolean newValue)

Наборы, ли parse(java.lang.String, java.text.ParsePosition) возвраты метода BigDecimal.

С тех пор:

1.5

См. Также:

isParseBigDecimal()

клон

public Object clone()

Стандартное переопределение; никакое изменение в семантике.

Переопределения:

clone в классе NumberFormat

Возвраты:

клон этого экземпляра.

См. Также:

Cloneable

равняется

public boolean equals(Object obj)

Переопределения равняются

Переопределения:

equals в классе NumberFormat

Параметры:

obj - ссылочный объект, с которым можно сравниться.

Возвраты:

true если этот объект является тем же самым как obj параметром; false иначе.

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

Хэш-код переопределений

Переопределения:

hashCode в классе NumberFormat

Возвраты:

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

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toPattern

public String toPattern()

Синтезирует строку образца, которая представляет текущее состояние этого объекта Формата.

См. Также:

applyPattern(java.lang.String)

toLocalizedPattern

public String toLocalizedPattern()

Синтезирует локализованную строку образца, которая представляет текущее состояние этого объекта Формата.

См. Также:

applyPattern(java.lang.String)

applyPattern

public void applyPattern(String pattern)

Примените данный образец к этому объекту Формата. Образец является краткой спецификацией для различных свойств форматирования. Эти свойства могут также быть изменены индивидуально через различные методы метода set.

Нет никакого предела целочисленным цифрам, установленным этой подпрограммой, так как это - типичное требование конечного пользователя; используйте setMaximumInteger, если Вы хотите установить действительное значение. Для отрицательных чисел используйте второй образец, разделенный точкой с запятой

Пример "#,#00.0#" -> 1,234.56

Это означает минимум 2 целочисленных цифр, 1 дробной цифры, и максимума 2 дробных цифр.

Пример: "#,#00.0#;(#,#00.0#)" для отрицаний в круглых скобках.

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

Броски:

NullPointerException - если pattern нуль

IllegalArgumentException - если данный образец недопустим.

applyLocalizedPattern

public void applyLocalizedPattern(String pattern)

Примените данный образец к этому объекту Формата. Образец, как предполагается, находится в локализованной нотации. Образец является краткой спецификацией для различных свойств форматирования. Эти свойства могут также быть изменены индивидуально через различные методы метода set.

Нет никакого предела целочисленным цифрам, установленным этой подпрограммой, так как это - типичное требование конечного пользователя; используйте setMaximumInteger, если Вы хотите установить действительное значение. Для отрицательных чисел используйте второй образец, разделенный точкой с запятой

Пример "#,#00.0#" -> 1,234.56

Это означает минимум 2 целочисленных цифр, 1 дробной цифры, и максимума 2 дробных цифр.

Пример: "#,#00.0#;(#,#00.0#)" для отрицаний в круглых скобках.

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

Броски:

NullPointerException - если pattern нуль

IllegalArgumentException - если данный образец недопустим.

setMaximumIntegerDigits

public void setMaximumIntegerDigits(int newValue)

Устанавливает максимальное количество цифр, позволенных в целочисленной части числа. Для того, чтобы отформатировать числа кроме BigInteger и BigDecimal объекты, ниже newValue и 309 используется. Отрицательные входные значения заменяются 0.

Переопределения:

setMaximumIntegerDigits в классе NumberFormat

Параметры:

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

См. Также:

NumberFormat.setMaximumIntegerDigits(int)

setMinimumIntegerDigits

public void setMinimumIntegerDigits(int newValue)

Определяет минимальный номер цифр, позволенных в целочисленной части числа. Для того, чтобы отформатировать числа кроме BigInteger и BigDecimal объекты, ниже newValue и 309 используется. Отрицательные входные значения заменяются 0.

Переопределения:

setMinimumIntegerDigits в классе NumberFormat

Параметры:

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

См. Также:

NumberFormat.setMinimumIntegerDigits(int)

setMaximumFractionDigits

public void setMaximumFractionDigits(int newValue)

Устанавливает максимальное количество цифр, позволенных в дробной части числа. Для того, чтобы отформатировать числа кроме BigInteger и BigDecimal объекты, ниже newValue и 340 используется. Отрицательные входные значения заменяются 0.

Переопределения:

setMaximumFractionDigits в классе NumberFormat

Параметры:

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

См. Также:

NumberFormat.setMaximumFractionDigits(int)

setMinimumFractionDigits

public void setMinimumFractionDigits(int newValue)

Определяет минимальный номер цифр, позволенных в дробной части числа. Для того, чтобы отформатировать числа кроме BigInteger и BigDecimal объекты, ниже newValue и 340 используется. Отрицательные входные значения заменяются 0.

Переопределения:

setMinimumFractionDigits в классе NumberFormat

Параметры:

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

См. Также:

NumberFormat.setMinimumFractionDigits(int)

getMaximumIntegerDigits

public int getMaximumIntegerDigits()

Получает максимальное количество цифр, позволенных в целочисленной части числа. Для того, чтобы отформатировать числа кроме BigInteger и BigDecimal объекты, ниже возвращаемого значения и 309 используются.

Переопределения:

getMaximumIntegerDigits в классе NumberFormat

См. Также:

setMaximumIntegerDigits(int)

getMinimumIntegerDigits

public int getMinimumIntegerDigits()

Получает минимальное число цифр, позволенных в целочисленной части числа. Для того, чтобы отформатировать числа кроме BigInteger и BigDecimal объекты, ниже возвращаемого значения и 309 используются.

Переопределения:

getMinimumIntegerDigits в классе NumberFormat

См. Также:

setMinimumIntegerDigits(int)

getMaximumFractionDigits

public int getMaximumFractionDigits()

Получает максимальное количество цифр, позволенных в дробной части числа. Для того, чтобы отформатировать числа кроме BigInteger и BigDecimal объекты, ниже возвращаемого значения и 340 используются.

Переопределения:

getMaximumFractionDigits в классе NumberFormat

См. Также:

setMaximumFractionDigits(int)

getMinimumFractionDigits

public int getMinimumFractionDigits()

Получает минимальное число цифр, позволенных в дробной части числа. Для того, чтобы отформатировать числа кроме BigInteger и BigDecimal объекты, ниже возвращаемого значения и 340 используются.

Переопределения:

getMinimumFractionDigits в классе NumberFormat

См. Также:

setMinimumFractionDigits(int)

getCurrency

public Currency getCurrency()

Использовали валюту этим десятичным форматом, форматируя значения валюты. Валюта получается, вызывая DecimalFormatSymbols.getCurrency на символах этого числового формата.

Переопределения:

getCurrency в классе NumberFormat

Возвраты:

валюта, используемая этим десятичным форматом, или null

С тех пор:

1.4

setCurrency

public void setCurrency(Currency currency)

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

Переопределения:

setCurrency в классе NumberFormat

Параметры:

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

Броски:

NullPointerException - если currency нуль

С тех пор:

1.4

getRoundingMode

public RoundingMode getRoundingMode()

Добирается RoundingMode используемый в этом DecimalFormat.

Переопределения:

getRoundingMode в классе NumberFormat

Возвраты:

RoundingMode используемый для этого DecimalFormat.

С тех пор:

1.6

См. Также:

setRoundingMode(RoundingMode)

setRoundingMode

public void setRoundingMode(RoundingMode roundingMode)

Наборы RoundingMode используемый в этом DecimalFormat.

Переопределения:

setRoundingMode в классе NumberFormat

Параметры:

roundingMode - RoundingMode использоваться

Броски:

NullPointerException - если roundingMode нуль.

С тех пор:

1.6

См. Также:

getRoundingMode()