Spec-Zone.ru › OpenJDK 25

Класс DecimalFormatSymbols

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

Если локаль содержит расширение Unicode "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

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

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
Требования к реализации:
Для вычисления значения хеш-кода используются нетранзиентные поля экземпляра этого класса. Полученное значение соответствует контракту, определенному в Objects.hashCode(Object).
Возвращает:
хеш-код этого DecimalFormatSymbols
См. также:
  • Object.hashCode()

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/text/DecimalFormatSymbols.html

Spec-Zone.ru

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