Spec-Zone.ru › OpenJDK 24

Класс 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
См. также:
  • 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.
END_OF_DOCUMENT_MARKER
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)).

См. также:
  • 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()
Возвращает массив всех локалей, для которых методы этого класса могут возвращать локализованные экземпляры. Возвращаемый массив представляет собой объединение локалей, поддерживаемых средой выполнения 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()
Получает символ, используемый для представления знака минус. Если явный формат отрицательного числа не указан, он формируется путём добавления минусSign к положительному формату.
Возвращает:
символ, представляющий знак минус

setMinusSign

public void setMinusSign(char minusSign)
Устанавливает символ, используемый для представления знака минус. Если явный формат отрицательного числа не указан, он формируется путём добавления минусSign к положительному формату.
Параметры:
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 соответствующему объекту Currency и атрибут currency symbol к символу валюты в локали DecimalFormatSymbols. Если код валюты некорректен, атрибут currency и атрибут currency symbol не изменяются.
Параметры:
currencyCode - код валюты
Издаёт исключение:
NullPointerException - если currencyCode равно null
С тех пор как:
1.2
См. также:
  • setCurrency(java.util.Currency)
  • setCurrencySymbol(java.lang.String)

getCurrency

public Currency getCurrency()
Возвращает валюту этого DecimalFormatSymbols.
Возвращает:
валюту этого DecimalFormatSymbols
С тех пор как:
1.4

setCurrency

public void setCurrency(Currency currency)
Устанавливает валюту для этого DecimalFormatSymbols. Это также устанавливает атрибут currency symbol в символ валюты в локали DecimalFormatSymbols и атрибут международного символа валюты в код валюты ISO 4217.
Параметры:
currency - новая валюта
Издаёт исключение:
NullPointerException - если currency равно null
С тех пор как:
1.4
См. также:
  • setCurrencySymbol(java.lang.String)
  • setInternationalCurrencySymbol(java.lang.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(java.lang.Object).
Возвращает:
хеш-код для этого DecimalFormatSymbols
См. также:
  • Object.hashCode()

© 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/text/DecimalFormatSymbols.html

Spec-Zone.ru

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