DecimalFormat (Платформа Java SE 8 b92)

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:
         Prefix_opt Number Suffix_opt
 NegativePattern:
         Prefix_opt Number Suffix_opt
 Prefix:
         any Unicode characters except \uFFFE, \uFFFF, and special characters
 Suffix:
         any Unicode characters except \uFFFE, \uFFFF, and special characters
 Number:
         Integer Exponent_opt
         Integer . Fraction Exponent_opt
 Integer:
         MinimumInteger
         #
         # Integer
         # , Integer
 MinimumInteger:
         0
         0 MinimumInteger
         0 , MinimumInteger
 Fraction:
         MinimumFraction_opt OptionalFraction_opt
 MinimumFraction:
         0 MinimumFraction_opt
 OptionalFraction:
         # OptionalFraction_opt
 Exponent:
         E MinimumExponent
 MinimumExponent:
         0 MinimumExponent_opt

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".

Символ	Расположение	Локализованный?	Значение
`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, Сериализированная Форма

Вложенная Сводка Класса
- Вложенные классы/интерфейсы, наследованные от class java.text. NumberFormat
  NumberFormat. Поле

Полевая Сводка
- Поля, наследованные от class java.text. NumberFormat
  FRACTION_FIELD, INTEGER_FIELD

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

Конструкторы
Конструктор и Описание
`DecimalFormat()` Создает DecimalFormat, используя образец значения по умолчанию и символы для значения по умолчанию `FORMAT` локаль.
`DecimalFormat(String pattern)` Создает DecimalFormat, используя данный образец и символы для значения по умолчанию `FORMAT` локаль.
`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`	`setGroupingUsed(boolean 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()` Синтезирует строку образца, которая представляет текущее состояние этого объекта Формата.

Методы, наследованные от class java.text. NumberFormat
format, format, getAvailableLocales, getCurrencyInstance, getCurrencyInstance, getInstance, getInstance, getIntegerInstance, getIntegerInstance, getNumberInstance, getNumberInstance, getPercentInstance, getPercentInstance, isGroupingUsed, isParseIntegerOnly, parse, parseObject, setParseIntegerOnly

Методы, наследованные от class java.text. Формат
format, parseObject

Методы, наследованные от class java.lang. Объект
finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - DecimalFormat
```
public DecimalFormat()
```
    Создает DecimalFormat, используя образец значения по умолчанию и символы для значения по умолчанию FORMAT локаль. Это - удобный способ получить DecimalFormat, когда интернационализация не является основным беспокойством.
    Чтобы получить стандартные форматы для данной локали, используйте методы фабрики на NumberFormat, такие как getNumberInstance. Эти фабрики возвратят самый соответствующий sub-class NumberFormat для данной локали.
    
    См. Также:
    
    NumberFormat.getInstance(), NumberFormat.getNumberInstance(), NumberFormat.getCurrencyInstance(), NumberFormat.getPercentInstance()
  - DecimalFormat
```
public DecimalFormat(String pattern)
```
    Создает DecimalFormat, используя данный образец и символы для значения по умолчанию FORMAT локаль. Это - удобный способ получить DecimalFormat, когда интернационализация не является основным беспокойством.
    Чтобы получить стандартные форматы для данной локали, используйте методы фабрики на NumberFormat, такие как getNumberInstance. Эти фабрики возвратят самый соответствующий sub-class 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 в class 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 в class NumberFormat
    
    Параметры:
    
    number - Вдвое большее по сравнению с форматом
    
    result - где текст должен быть добавлен
    
    fieldPosition - На вводе: поле выравнивания, при желании. На выводе: смещения поля выравнивания.
    
    Возвраты:
    
    Отформатированная строка числа
    
    Броски:
    
    ArithmeticException - если округление необходимо с округлением режима, устанавливаемого в RoundingMode. НЕНУЖНЫЙ
    
    См. Также:
    
    FieldPosition
  - формат
```
public StringBuffer format(long number,
                           StringBuffer result,
                           FieldPosition fieldPosition)
```
    Отформатируйте длинное, чтобы произвести строку.
    
    Определенный:
    
    format в class NumberFormat
    
    Параметры:
    
    number - Длинное, чтобы отформатировать
    
    result - где текст должен быть добавлен
    
    fieldPosition - На вводе: поле выравнивания, при желании. На выводе: смещения поля выравнивания.
    
    Возвраты:
    
    Отформатированная строка числа
    
    Броски:
    
    ArithmeticException - если округление необходимо с округлением режима, устанавливаемого в RoundingMode. НЕНУЖНЫЙ
    
    См. Также:
    
    FieldPosition
  - formatToCharacterIterator
```
public AttributedCharacterIterator formatToCharacterIterator(Object obj)
```
    Форматирует Объект, производящий AttributedCharacterIterator. Можно использовать возвращенный AttributedCharacterIterator создать получающуюся Строку, так же как определить информацию о получающейся Строке.
    Каждый ключ атрибута AttributedCharacterIterator будет иметь тип NumberFormat.Field, со значением атрибута, являющимся тем же самым как ключ атрибута.
    
    Переопределения:
    
    formatToCharacterIterator в class 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 в class 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()
  - setGroupingUsed
```
public void setGroupingUsed(boolean newValue)
```
    Набор, будет ли группировка использоваться в этом формате.
    
    Переопределения:
    
    setGroupingUsed в class NumberFormat
    
    См. Также:
    
    NumberFormat.isGroupingUsed()
  - 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 в class NumberFormat
    
    Возвраты:
    
    клон этого экземпляра.
    
    См. Также:
    
    Cloneable
  - равняется
```
public boolean equals(Object obj)
```
    Переопределения равняются
    
    Переопределения:
    
    equals в class NumberFormat
    
    Параметры:
    
    obj - ссылочный объект, с которым можно сравниться.
    
    Возвраты:
    
    true если этот объект является тем же самым как obj параметром; false иначе.
    
    См. Также:
    
    Object.hashCode(), HashMap
  - хэш-код
```
public int hashCode()
```
    Хэш-код переопределений
    
    Переопределения:
    
    hashCode в class 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 в class NumberFormat
    
    Параметры:
    
    newValue - максимальное количество целочисленных цифр, которые будут показаны; если меньше чем нуль, то обнулите, используется. Конкретный подкласс может осуществить верхний предел этому значению, соответствующему числовому отформатированному типу.
    
    См. Также:
    
    NumberFormat.setMaximumIntegerDigits(int)
  - setMinimumIntegerDigits
```
public void setMinimumIntegerDigits(int newValue)
```
    Определяет минимальный номер цифр, позволенных в целочисленной части числа. Для того, чтобы отформатировать числа кроме BigInteger и BigDecimal объекты, ниже newValue и 309 используется. Отрицательные входные значения заменяются 0.
    
    Переопределения:
    
    setMinimumIntegerDigits в class NumberFormat
    
    Параметры:
    
    newValue - минимальное число целочисленных цифр, которые будут показаны; если меньше чем нуль, то обнулите, используется. Конкретный подкласс может осуществить верхний предел этому значению, соответствующему числовому отформатированному типу.
    
    См. Также:
    
    NumberFormat.setMinimumIntegerDigits(int)
  - setMaximumFractionDigits
```
public void setMaximumFractionDigits(int newValue)
```
    Устанавливает максимальное количество цифр, позволенных в дробной части числа. Для того, чтобы отформатировать числа кроме BigInteger и BigDecimal объекты, ниже newValue и 340 используется. Отрицательные входные значения заменяются 0.
    
    Переопределения:
    
    setMaximumFractionDigits в class NumberFormat
    
    Параметры:
    
    newValue - максимальное количество дробных цифр, которые будут показаны; если меньше чем нуль, то обнулите, используется. Конкретный подкласс может осуществить верхний предел этому значению, соответствующему числовому отформатированному типу.
    
    См. Также:
    
    NumberFormat.setMaximumFractionDigits(int)
  - setMinimumFractionDigits
```
public void setMinimumFractionDigits(int newValue)
```
    Определяет минимальный номер цифр, позволенных в дробной части числа. Для того, чтобы отформатировать числа кроме BigInteger и BigDecimal объекты, ниже newValue и 340 используется. Отрицательные входные значения заменяются 0.
    
    Переопределения:
    
    setMinimumFractionDigits в class NumberFormat
    
    Параметры:
    
    newValue - минимальное число дробных цифр, которые будут показаны; если меньше чем нуль, то обнулите, используется. Конкретный подкласс может осуществить верхний предел этому значению, соответствующему числовому отформатированному типу.
    
    См. Также:
    
    NumberFormat.setMinimumFractionDigits(int)
  - getMaximumIntegerDigits
```
public int getMaximumIntegerDigits()
```
    Получает максимальное количество цифр, позволенных в целочисленной части числа. Для того, чтобы отформатировать числа кроме BigInteger и BigDecimal объекты, ниже возвращаемого значения и 309 используются.
    
    Переопределения:
    
    getMaximumIntegerDigits в class NumberFormat
    
    См. Также:
    
    setMaximumIntegerDigits(int)
  - getMinimumIntegerDigits
```
public int getMinimumIntegerDigits()
```
    Получает минимальное число цифр, позволенных в целочисленной части числа. Для того, чтобы отформатировать числа кроме BigInteger и BigDecimal объекты, ниже возвращаемого значения и 309 используются.
    
    Переопределения:
    
    getMinimumIntegerDigits в class NumberFormat
    
    См. Также:
    
    setMinimumIntegerDigits(int)
  - getMaximumFractionDigits
```
public int getMaximumFractionDigits()
```
    Получает максимальное количество цифр, позволенных в дробной части числа. Для того, чтобы отформатировать числа кроме BigInteger и BigDecimal объекты, ниже возвращаемого значения и 340 используются.
    
    Переопределения:
    
    getMaximumFractionDigits в class NumberFormat
    
    См. Также:
    
    setMaximumFractionDigits(int)
  - getMinimumFractionDigits
```
public int getMinimumFractionDigits()
```
    Получает минимальное число цифр, позволенных в дробной части числа. Для того, чтобы отформатировать числа кроме BigInteger и BigDecimal объекты, ниже возвращаемого значения и 340 используются.
    
    Переопределения:
    
    getMinimumFractionDigits в class NumberFormat
    
    См. Также:
    
    setMinimumFractionDigits(int)
  - getCurrency
```
public Currency getCurrency()
```
    Использовали валюту этим десятичным форматом, форматируя значения валюты. Валюта получается, вызывая DecimalFormatSymbols.getCurrency на символах этого числового формата.
    
    Переопределения:
    
    getCurrency в class NumberFormat
    
    Возвраты:
    
    валюта, используемая этим десятичным форматом, или null
    
    С тех пор:
    
    1.4
  - setCurrency
```
public void setCurrency(Currency currency)
```
    Устанавливает валюту, используемую этим числовым форматом, форматируя значения валюты. Это не обновляет минимальное или максимальное количество дробных цифр, используемых числовым форматом. Валюта устанавливается, вызывая DecimalFormatSymbols.setCurrency на символах этого числового формата.
    
    Переопределения:
    
    setCurrency в class NumberFormat
    
    Параметры:
    
    currency - новая валюта, которая будет использоваться этим десятичным форматом
    
    Броски:
    
    NullPointerException - если currency нуль
    
    С тех пор:
    
    1.4
  - getRoundingMode
```
public RoundingMode getRoundingMode()
```
    Добирается RoundingMode используемый в этом DecimalFormat.
    
    Переопределения:
    
    getRoundingMode в class NumberFormat
    
    Возвраты:
    
    RoundingMode используемый для этого DecimalFormat.
    
    С тех пор:
    
    1.6
    
    См. Также:
    
    setRoundingMode(RoundingMode)
  - setRoundingMode
```
public void setRoundingMode(RoundingMode roundingMode)
```
    Наборы RoundingMode используемый в этом DecimalFormat.
    
    Переопределения:
    
    setRoundingMode в class NumberFormat
    
    Параметры:
    
    roundingMode - RoundingMode использоваться
    
    Броски:
    
    NullPointerException - если roundingMode нуль.
    
    С тех пор:
    
    1.6
    
    См. Также:
    
    getRoundingMode()

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс DecimalFormat

Образцы

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

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

Округление

Цифры

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

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

Пример

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

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

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

Поля, наследованные от class java.text. NumberFormat

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

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

Методы, наследованные от class java.text. NumberFormat

Методы, наследованные от class java.text. Формат

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

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

DecimalFormat

DecimalFormat

DecimalFormat

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

формат

формат

формат

formatToCharacterIterator

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

getDecimalFormatSymbols

setDecimalFormatSymbols

getPositivePrefix

setPositivePrefix

getNegativePrefix

setNegativePrefix

getPositiveSuffix

setPositiveSuffix

getNegativeSuffix

setNegativeSuffix

getMultiplier

setMultiplier

setGroupingUsed

getGroupingSize

setGroupingSize

isDecimalSeparatorAlwaysShown

setDecimalSeparatorAlwaysShown

isParseBigDecimal

setParseBigDecimal

клон

равняется

хэш-код

toPattern

toLocalizedPattern

applyPattern

applyLocalizedPattern

setMaximumIntegerDigits

setMinimumIntegerDigits

setMaximumFractionDigits

setMinimumFractionDigits

getMaximumIntegerDigits

getMinimumIntegerDigits

getMaximumFractionDigits

getMinimumFractionDigits

getCurrency

setCurrency

getRoundingMode

setRoundingMode