Класс DecimalFormatSymbols

java.lang.Object

java.text.DecimalFormatSymbols

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

public class DecimalFormatSymbols extends Object implements Cloneable, Serializable

Этот класс представляет набор символов (таких как десятичная запятая, разделитель группировки и т. д.), необходимых классу DecimalFormat для форматирования чисел. DecimalFormat создаёт для себя экземпляр DecimalFormatSymbols из данных своего языка. Если вам нужно изменить любой из этих символов, вы можете получить объект DecimalFormatSymbols из вашего объекта DecimalFormat и изменить его.

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

С:

1.1

См. также:

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

Конструктор	Описание
`DecimalFormatSymbols()`	Создаёт объект DecimalFormatSymbols для локали по умолчанию `FORMAT`.
`DecimalFormatSymbols(Locale locale)`	Создаёт объект DecimalFormatSymbols для заданной локали.

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

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Стандартное переопределение.
`boolean`	`equals(Object obj)`	Переопределение equals.
`static Locale[]`	`getAvailableLocales()`	Возвращает массив всех локалей, для которых методы `getInstance` этого класса могут вернуть локализованные экземпляры.
`Currency`	`getCurrency()`	Возвращает валюту этих DecimalFormatSymbols.
`String`	`getCurrencySymbol()`	Возвращает символ валюты для валюты этих DecimalFormatSymbols в их локали.
`char`	`getDecimalSeparator()`	Возвращает символ, используемый для десятичного знака.
`char`	`getDigit()`	Возвращает символ, используемый для цифры в шаблоне.
`String`	`getExponentSeparator()`	Возвращает строку, используемую для разделения мантиссы и экспоненты.
`char`	`getGroupingSeparator()`	Возвращает символ, используемый для разделителя группировки.
`String`	`getInfinity()`	Возвращает строку, используемую для представления бесконечности.
`static final DecimalFormatSymbols`	`getInstance()`	Возвращает экземпляр `DecimalFormatSymbols` для локали по умолчанию.
`static final DecimalFormatSymbols`	`getInstance(Locale locale)`	Возвращает экземпляр `DecimalFormatSymbols` для указанной локали.
`String`	`getInternationalCurrencySymbol()`	Возвращает код валюты ISO 4217 для валюты этих DecimalFormatSymbols.
`Locale`	`getLocale()`	Возвращает локаль, используемую для создания этого экземпляра.
`char`	`getMinusSign()`	Возвращает символ, используемый для представления минуса.
`char`	`getMonetaryDecimalSeparator()`	Возвращает десятичный разделитель для валюты.
`char`	`getMonetaryGroupingSeparator()`	Возвращает символ, используемый для разделителя группировки для валют.
`String`	`getNaN()`	Возвращает строку, используемую для представления «не число».
`char`	`getPatternSeparator()`	Возвращает символ, используемый для разделения положительных и отрицательных подшаблонов в шаблоне.
`char`	`getPercent()`	Возвращает символ, используемый для процента.
`char`	`getPerMill()`	Возвращает символ, используемый для промилле.
`char`	`getZeroDigit()`	Возвращает символ, используемый для нуля.
`int`	`hashCode()`	Переопределение hashCode.
`void`	`setCurrency(Currency currency)`	Устанавливает валюту этих DecimalFormatSymbols.
`void`	`setCurrencySymbol(String currency)`	Устанавливает символ валюты для валюты этих DecimalFormatSymbols в их локали.
`void`	`setDecimalSeparator(char decimalSeparator)`	Устанавливает символ, используемый для десятичного знака.
`void`	`setDigit(char digit)`	Устанавливает символ, используемый для цифры в шаблоне.
`void`	`setExponentSeparator(String exp)`	Устанавливает строку, используемую для разделения мантиссы и экспоненты.
`void`	`setGroupingSeparator(char groupingSeparator)`	Устанавливает символ, используемый для разделителя группировки.
`void`	`setInfinity(String infinity)`	Устанавливает строку, используемую для представления бесконечности.
`void`	`setInternationalCurrencySymbol(String currencyCode)`	Устанавливает код валюты ISO 4217 для валюты этих DecimalFormatSymbols.
`void`	`setMinusSign(char minusSign)`	Устанавливает символ, используемый для представления минуса.
`void`	`setMonetaryDecimalSeparator(char sep)`	Устанавливает десятичный разделитель для валюты.
`void`	`setMonetaryGroupingSeparator(char monetaryGroupingSeparator)`	Устанавливает символ, используемый для разделителя группировки для валют.
`void`	`setNaN(String NaN)`	Устанавливает строку, используемую для представления «не число».
`void`	`setPatternSeparator(char patternSeparator)`	Устанавливает символ, используемый для разделения положительных и отрицательных подшаблонов в шаблоне.
`void`	`setPercent(char percent)`	Устанавливает символ, используемый для процента.
`void`	`setPerMill(char perMill)`	Устанавливает символ, используемый для промилле.
`void`	`setZeroDigit(char zeroDigit)`	Устанавливает символ, используемый для нуля.

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

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

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

DecimalFormatSymbols

public DecimalFormatSymbols()

Создаёт объект DecimalFormatSymbols для локали по умолчанию FORMAT. Данный конструктор может создавать экземпляры только для локалей, поддерживаемых средой выполнения Java, а не для тех, которые поддерживаются установленными реализациями DecimalFormatSymbolsProvider. Для полной поддержки локалей используйте метод getInstance.

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

См. также:

DecimalFormatSymbols

public DecimalFormatSymbols(Locale locale)

Создаёт объект DecimalFormatSymbols для заданной локали. Данный конструктор может создавать экземпляры только для локалей, поддерживаемых средой выполнения Java, а не для тех, которые поддерживаются установленными реализациями DecimalFormatSymbolsProvider. Для полной поддержки локалей используйте метод getInstance. Если указанная локаль содержит Locale.UNICODE_LOCALE_EXTENSION для системы счисления, экземпляр инициализируется с указанной системой счисления, если реализация JRE её поддерживает. Например,

 NumberFormat.getNumberInstance(Locale.forLanguageTag("th-TH-u-nu-thai"))

Это может вернуть экземпляр NumberFormat с тайской системой счисления, а не латинской.

Параметры:: locale - желаемая локаль
Исключения:: NullPointerException - если locale равно null

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

getAvailableLocales

public static Locale[] getAvailableLocales()

Возвращает массив всех локалей, для которых методы этого класса могут возвращать локализованные экземпляры. Возвращаемый массив представляет собой объединение локалей, поддерживаемых средой выполнения Java и установленными реализациями DecimalFormatSymbolsProvider. Как минимум, возвращаемый массив должен содержать экземпляр Locale равный Locale.ROOT и экземпляр Locale равный Locale.US.

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

getInstance

public static final DecimalFormatSymbols getInstance()

Возвращает экземпляр DecimalFormatSymbols для локали по умолчанию. Данный метод предоставляет доступ к экземплярам DecimalFormatSymbols для локалей, поддерживаемых самой средой выполнения Java, а также для тех, которые поддерживаются установленными реализациями DecimalFormatSymbolsProvider.

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

Возвращает:

экземпляр DecimalFormatSymbols.

С версии:

1.6

См. также:

getInstance

public static final DecimalFormatSymbols getInstance(Locale locale)

Возвращает экземпляр DecimalFormatSymbols для указанной локали. Данный метод предоставляет доступ к экземплярам DecimalFormatSymbols для локалей, поддерживаемых самой средой выполнения Java, а также для тех, которые поддерживаются установленными реализациями DecimalFormatSymbolsProvider. Если указанная локаль содержит Locale.UNICODE_LOCALE_EXTENSION для системы счисления, экземпляр инициализируется с указанной системой счисления, если реализация JRE её поддерживает. Например,

 NumberFormat.getNumberInstance(Locale.forLanguageTag("th-TH-u-nu-thai"))

Это может вернуть экземпляр NumberFormat с тайской системой счисления, а не латинской.

Параметры:: locale - желаемая локаль.
Возвращает:: экземпляр DecimalFormatSymbols.
Исключения:: NullPointerException - если locale равно null
С версии:: 1.6

getLocale

public Locale getLocale()

Возвращает локаль, используемую для создания этого экземпляра.

Возвращает:: локаль, используемую для создания этого экземпляра
С версии:: 19

getZeroDigit

public char getZeroDigit()

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

Возвращает:: символ, используемый для нуля

setZeroDigit

public void setZeroDigit(char zeroDigit)

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

Параметры:: zeroDigit - символ, используемый для нуля

getGroupingSeparator

public char getGroupingSeparator()

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

Возвращает:: разделитель групп

setGroupingSeparator

public void setGroupingSeparator(char groupingSeparator)

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

Параметры:: groupingSeparator - разделитель групп

getDecimalSeparator

public char getDecimalSeparator()

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

Возвращает:: символ, используемый в качестве десятичного знака

setDecimalSeparator

public void setDecimalSeparator(char decimalSeparator)

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

Параметры:: decimalSeparator - символ, используемый в качестве десятичного знака

getPerMill

public char getPerMill()

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

Возвращает:: символ, используемый в качестве знака промилле

setPerMill

public void setPerMill(char perMill)

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

Параметры:: perMill - символ, используемый в качестве знака промилле

getPercent

public char getPercent()

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

Возвращает:: символ, используемый в качестве знака процента

setPercent

public void setPercent(char percent)

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

Параметры:: percent - символ, используемый в качестве знака процента

getDigit

public char getDigit()

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

Возвращает:: символ, используемый для цифры в шаблоне

setDigit

public void setDigit(char digit)

Устанавливает символ, используемый для цифры в шаблоне.

Параметры:: digit - символ, используемый для цифры в шаблоне

getPatternSeparator

public char getPatternSeparator()

Возвращает символ, используемый для разделения положительных и отрицательных подшаблонов в шаблоне.

Возвращает:: разделитель шаблонов

setPatternSeparator

public void setPatternSeparator(char patternSeparator)

Устанавливает символ, используемый для разделения положительных и отрицательных подшаблонов в шаблоне.

Параметры:: patternSeparator - разделитель шаблонов

getInfinity

public String getInfinity()

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

Возвращает:: строка, представляющая бесконечность

setInfinity

public void setInfinity(String infinity)

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

Параметры:: infinity - строка, представляющая бесконечность

getNaN

public String getNaN()

Возвращает строку, используемую для представления "не число". Почти всегда остаётся без изменений.

Возвращает:: строка, представляющая "не число"

setNaN

public void setNaN(String NaN)

Устанавливает строку, используемую для представления "не число". Почти всегда остаётся без изменений.

Параметры:: NaN - строка, представляющая "не число"

getMinusSign

public char getMinusSign()

Возвращает символ, используемый для обозначения знака минус. Если нет явного отрицательного формата, он формируется путём добавления минусSign к положительному формату.

Возвращает:: символ, представляющий знак минус

Установить знак минус

public void setMinusSign(char minusSign)

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

Параметры:: minusSign - символ, представляющий знак минус

Получить символ валюты

public String getCurrencySymbol()

Возвращает символ валюты для валюты этих DecimalFormatSymbols в их локали.

Возвращает:: символ валюты
С:: 1.2

Установить символ валюты

public void setCurrencySymbol(String currency)

Устанавливает символ валюты для валюты этих DecimalFormatSymbols в их локали.

Параметры:: currency - символ валюты
С:: 1.2

Получить международный символ валюты

public String getInternationalCurrencySymbol()

Возвращает код валюты ISO 4217 для валюты этих DecimalFormatSymbols.

Возвращает:: код валюты
С:: 1.2

Установить международный символ валюты

public void setInternationalCurrencySymbol(String currencyCode)

Устанавливает код валюты ISO 4217 для валюты этих DecimalFormatSymbols. Если код валюты является корректным (как определено в Currency.getInstance), это также устанавливает атрибут валюты на соответствующий экземпляр Currency и атрибут символа валюты на символ валюты в локали DecimalFormatSymbols. Если код валюты некорректен, атрибут валюты устанавливается в null, а атрибут символа валюты не изменяется.

Параметры:

currencyCode - код валюты

С:

1.2

См. также:

Получить валюту

public Currency getCurrency()

Получает валюту этих DecimalFormatSymbols. Может быть null, если атрибут символа валюты ранее был установлен на значение, которое не является корректным кодом валюты ISO 4217.

Возвращает:: используемая валюта, или null
С:: 1.4

Установить валюту

public void setCurrency(Currency currency)

Устанавливает валюту этих DecimalFormatSymbols. Это также устанавливает атрибут символа валюты на символ валюты в локали DecimalFormatSymbols и атрибут международного символа валюты на код валюты ISO 4217.

Параметры:

currency - новая валюта для использования

Исключения:

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

С:

1.4

См. также:

Получить десятичный разделитель для валюты

public char getMonetaryDecimalSeparator()

Возвращает десятичный разделитель для валюты.

Возвращает:: десятичный разделитель для валюты
С:: 1.2

Установить десятичный разделитель для валюты

public void setMonetaryDecimalSeparator(char sep)

Устанавливает десятичный разделитель для валюты.

Параметры:: sep - десятичный разделитель для валюты
С:: 1.2

Получить разделитель порядка

public String getExponentSeparator()

Возвращает строку, используемую для разделения мантиссы и порядка. Примеры: "x10^" для 1.23x10^4, "E" для 1.23E4.

Возвращает:

строку-разделитель порядка

С:

1.6

См. также:

Установить разделитель порядка

public void setExponentSeparator(String exp)

Устанавливает строку, используемую для разделения мантиссы и порядка. Примеры: "x10^" для 1.23x10^4, "E" для 1.23E4.

Параметры:

exp - строка-разделитель порядка

Исключения:

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

С:

1.6

См. также:

Получить разделитель группирования для валюты

public char getMonetaryGroupingSeparator()

Получает символ, используемый в качестве разделителя группирования для валют. Может отличаться от grouping separator в некоторых локалях, например, в немецкой локали Австрии.

Возвращает:: разделитель группирования для валюты
С:: 15

Установить разделитель группирования для валюты

public void setMonetaryGroupingSeparator(char monetaryGroupingSeparator)

Устанавливает символ, используемый в качестве разделителя группирования для валют. Вызов этого метода не повлияет на обычный grouping separator.

Параметры:

monetaryGroupingSeparator - разделитель группирования для валюты

С:

См. также:

клонировать

public Object clone()

Стандартная перегрузка.

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

clone в классе Object

Возвращает:

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

См. также:

равен

public boolean equals(Object obj)

Переопределение equals.

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

equals в классе Object

Параметры:

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

Возвращает:

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

См. также:

hashCode

public int hashCode()

Переопределение hashCode.

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

hashCode в классе Object

Возвращает:

код хэша для этого объекта.

См. также:

© 1993, 2023, 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/21/docs/api/java.base/java/text/DecimalFormatSymbols.html