Spec-Zone.ru › OpenJDK 27

Класс DecimalFormatSymbols

java.lang.Object
java.text.DecimalFormatSymbols
Все реализованные интерфейсы:
Serializable, Cloneable
public class DecimalFormatSymbols extends Object implements Cloneable, Serializable
Этот класс представляет набор символов (например, десятичный разделитель, разделитель групп разрядов и т. д.), необходимых DecimalFormat для форматирования чисел. DecimalFormat создаёт для себя экземпляр DecimalFormatSymbols на основе данных локали. Если требуется изменить какие-либо из этих символов, можно получить объект DecimalFormatSymbols из DecimalFormat и изменить его.

Поддерживаются Locale расширения Unicode «rg» (переопределение региона), «nu» (система нумерации) и «cu» (валюта), которые могут переопределять значения символов. Для «nu» и «cu», если они указаны в дополнение к «rg» в исходной Locale, соответствующие значения из расширений «nu» и «cu» имеют приоритет над неявными значениями из расширения «rg».

Начиная с:
1.1
См. также:
  • Locale
  • DecimalFormat
  • Сериализованная форма

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

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

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

Модификатор и тип Метод Описание
Object clone()
Стандартное переопределение.
boolean equals(Object obj)
Сравнивает указанный объект с этим DecimalFormatSymbols на равенство.
static Locale[] getAvailableLocales()
Возвращает массив всех локалей, для которых методы getInstance этого класса могут возвращать локализованные экземпляры.
Currency getCurrency()
Возвращает Currency этого 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()
Возвращает хеш-код этого DecimalFormatSymbols.
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)
Задаёт символ, используемый для обозначения нуля.

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

finalize, getClass, notify, notifyAll, toString, wait, wait, wait
Модификатор и тип Метод Описание
protected void finalize()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Финализация объявлена устаревшей и будет удалена в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
String toString()
Возвращает строковое представление объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

DecimalFormatSymbols

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

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

См. также:
  • Locale.getDefault(java.util.Locale.Category)
  • 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()
Возвращает массив всех локалей, для которых методы getInstance этого класса могут возвращать локализованные экземпляры. Возвращенный массив представляет собой объединение локалей, поддерживаемых средой выполнения 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
См. также:
  • Locale.getDefault(java.util.Locale.Category)
  • Locale.Category.FORMAT

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 — строка, представляющая бесконечность
Вызывает исключение:
NullPointerException — если infinity имеет значение null

getNaN

public String getNaN()
Возвращает строку, используемую для представления «не числа». Почти всегда остается неизменной.
Возвращает:
строка, представляющая «не число»

setNaN

public void setNaN(String NaN)
Задает строку, используемую для представления «не числа». Почти всегда остается неизменной.
Параметры:
NaN — строка, представляющая «не число»
Вызывает исключение:
NullPointerException — если NaN имеет значение null

getMinusSign

public char getMinusSign()
Возвращает символ, используемый для обозначения знака минус. Если явный отрицательный формат не задан, он формируется добавлением minusSign перед положительным форматом.
Возвращает:
символ, обозначающий знак минус

setMinusSign

public void setMinusSign(char minusSign)
Задает символ, используемый для обозначения знака минус. Если явный отрицательный формат не задан, он формируется добавлением minusSign перед положительным форматом.
Параметры:
minusSign — символ, обозначающий знак минус

getCurrencySymbol

public String getCurrencySymbol()
Возвращает символ валюты, соответствующей локали этих объектов DecimalFormatSymbols.
Возвращает:
символ валюты
Начиная с версии:
1.2

setCurrencySymbol

public void setCurrencySymbol(String currency)
Задает символ валюты, соответствующей локали этого DecimalFormatSymbols. В отличие от setInternationalCurrencySymbol(String), этот метод не обновляет атрибут валюты и атрибут международного символа валюты.
Параметры:
currency — символ валюты
Вызывает исключение:
NullPointerException — если currency имеет значение null
Начиная с версии:
1.2

getInternationalCurrencySymbol

public String getInternationalCurrencySymbol()
Возвращает код валюты по стандарту ISO 4217 для валюты этих объектов DecimalFormatSymbols.
Возвращает:
код валюты
Начиная с версии:
1.2

setInternationalCurrencySymbol

public void setInternationalCurrencySymbol(String currencyCode)
Задает код валюты по стандарту ISO 4217 для валюты этих объектов DecimalFormatSymbols. Если код валюты допустим (согласно определению в Currency.getInstance), также задается атрибут валюты, которому присваивается соответствующий экземпляр Currency, и атрибут символа валюты, которому присваивается символ валюты в локали DecimalFormatSymbols. Если код валюты недопустим, атрибут валюты и атрибут символа валюты не изменяются.
Параметры:
currencyCode — код валюты
Вызывает исключение:
NullPointerException — если currencyCode имеет значение null
Начиная с версии:
1.2
См. также:
  • setCurrency(Currency)
  • setCurrencySymbol(String)

getCurrency

public Currency getCurrency()
Возвращает Currency этого DecimalFormatSymbols.
Возвращает:
Currency этого DecimalFormatSymbols
Начиная с версии:
1.4

setCurrency

public void setCurrency(Currency currency)
Задает валюту для этого DecimalFormatSymbols. Также задается атрибут символа валюты, которому присваивается символ валюты в локали DecimalFormatSymbols, и атрибут международного символа валюты, которому присваивается код валюты ISO 4217.
Параметры:
currency — новая валюта
Вызывает исключение:
NullPointerException — если currency имеет значение null
Начиная с версии:
1.4
См. также:
  • setCurrencySymbol(String)
  • setInternationalCurrencySymbol(String)

getMonetaryDecimalSeparator

public char getMonetaryDecimalSeparator()
Возвращает денежный десятичный разделитель.
Возвращает:
денежный десятичный разделитель
Начиная с версии:
1.2

setMonetaryDecimalSeparator

public void setMonetaryDecimalSeparator(char sep)
Задает денежный десятичный разделитель.
Параметры:
sep — денежный десятичный разделитель
Начиная с версии:
1.2

getExponentSeparator

public String getExponentSeparator()
Возвращает строку, используемую для отделения мантиссы от экспоненты. Примеры: «x10^» для 1.23x10^4, «E» для 1.23E4.
Возвращает:
строка-разделитель экспоненты
Начиная с версии:
1.6
См. также:
  • setExponentSeparator(java.lang.String)

setExponentSeparator

public void setExponentSeparator(String exp)
Задает строку, используемую для отделения мантиссы от экспоненты. Примеры: «x10^» для 1.23x10^4, «E» для 1.23E4.
Параметры:
exp — строка-разделитель экспоненты
Вызывает исключение:
NullPointerException — если exp имеет значение null
Начиная с версии:
1.6
См. также:
  • getExponentSeparator()

getMonetaryGroupingSeparator

public char getMonetaryGroupingSeparator()
Возвращает символ-разделитель групп разрядов для валют. В некоторых локалях он может отличаться от grouping separator, например для немецкого языка в Австрии.
Возвращает:
денежный разделитель групп разрядов
Начиная с версии:
15

setMonetaryGroupingSeparator

public void setMonetaryGroupingSeparator(char monetaryGroupingSeparator)
Задает символ-разделитель групп разрядов для валют. Вызов этого метода не влияет на обычный grouping separator.
Параметры:
monetaryGroupingSeparator — денежный разделитель групп разрядов
Начиная с версии:
15
См. также:
  • setGroupingSeparator(char)

clone

public Object clone()
Стандартное переопределение.
Переопределяет:
clone в классе Object
Возвращает:
копию этого экземпляра.
См. также:
  • Cloneable

equals

public boolean equals(Object obj)
Сравнивает указанный объект с этим DecimalFormatSymbols на предмет равенства. Возвращает true, если объект также является DecimalFormatSymbols и оба объекта DecimalFormatSymbols представляют один и тот же набор символов.
Переопределяет:
equals в классе Object
Требования к реализации:
Этот метод проверяет равенство, определяя идентичность класса на основе getClass(), а не instanceof. Поэтому в методах equals подклассов ни один экземпляр этого класса не должен считаться равным экземпляру подкласса.
Параметры:
obj — объект для сравнения на равенство
Возвращает:
true, если указанный объект равен этому DecimalFormatSymbols
См. также:
  • Object.equals(Object)

hashCode

public int hashCode()
Возвращает хеш-код этого DecimalFormatSymbols.
Переопределяет:
hashCode в классе Object
Требования к реализации:
Для вычисления значения хеш-кода используются нест transientные поля экземпляра этого класса; полученный код соответствует контракту, определенному в Objects.hashCode(Object).
Возвращает:
хеш-код этого DecimalFormatSymbols
См. также:
  • Object.hashCode()

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, общие сведения, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2026, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API