Класс 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
- См. также:
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
DecimalFormatSymbols() |
Создаёт объект DecimalFormatSymbols для локали FORMAT по умолчанию. |
DecimalFormatSymbols |
Создаёт объект DecimalFormatSymbols для указанной локали. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Object |
clone() |
Стандартное переопределение. |
boolean |
equals |
Сравнивает указанный объект с этим 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 |
Возвращает экземпляр 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 |
Задаёт валюту для этого DecimalFormatSymbols. |
void |
setCurrencySymbol |
Задаёт символ валюты для валюты этого DecimalFormatSymbols в их локали. |
void |
setDecimalSeparator |
Задаёт символ, используемый в качестве десятичного разделителя. |
void |
setDigit |
Задаёт символ, используемый для обозначения цифры в шаблоне. |
void |
setExponentSeparator |
Задаёт строку, используемую для отделения мантиссы от экспоненты. |
void |
setGroupingSeparator |
Задаёт символ, используемый в качестве разделителя групп разрядов. |
void |
setInfinity |
Задаёт строку, используемую для представления бесконечности. |
void |
setInternationalCurrencySymbol |
Задаёт код валюты по стандарту ISO 4217 для валюты этих DecimalFormatSymbols. |
void |
setMinusSign |
Задаёт символ, используемый для обозначения знака минус. |
void |
setMonetaryDecimalSeparator |
Задаёт десятичный разделитель для денежных значений. |
void |
setMonetaryGroupingSeparator |
Задаёт символ, используемый в качестве разделителя групп разрядов для денежных значений. |
void |
setNaN |
Задаёт строку, используемую для обозначения значения «не число». |
void |
setPatternSeparator |
Задаёт символ, используемый для разделения положительного и отрицательного подшаблонов в шаблоне. |
void |
setPercent |
Задаёт символ, используемый в качестве знака процента. |
void |
setPerMill |
Задаёт символ, используемый в качестве знака промилле. |
void |
setZeroDigit |
Задаёт символ, используемый для обозначения нуля. |
Методы, объявленные в классе 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 |
Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени. |
final void |
wait |
Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени. |
Подробное описание конструкторов
DecimalFormatSymbols
public DecimalFormatSymbols()
FORMAT. Этот конструктор может создавать экземпляры только для локалей, поддерживаемых средой выполнения Java, но не для локалей, поддерживаемых установленными реализациями DecimalFormatSymbolsProvider. Для полного охвата локалей используйте метод getInstance. Это эквивалентно вызову DecimalFormatSymbols(Locale.getDefault(Locale.Category.FORMAT)).
- См. также:
DecimalFormatSymbols
public DecimalFormatSymbols(Locale locale)
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
- См. также:
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()
- Возвращает:
- символ, обозначающий знак минус
setMinusSign
public void setMinusSign(char minusSign)
- Параметры:
-
minusSign— символ, обозначающий знак минус
getCurrencySymbol
public String getCurrencySymbol()
- Возвращает:
- символ валюты
- Начиная с версии:
- 1.2
setCurrencySymbol
public void setCurrencySymbol(String currency)
DecimalFormatSymbols. В отличие от setInternationalCurrencySymbol(String), этот метод не обновляет атрибут валюты и атрибут международного символа валюты.- Параметры:
-
currency— символ валюты - Вызывает исключение:
-
NullPointerException— еслиcurrencyимеет значениеnull - Начиная с версии:
- 1.2
getInternationalCurrencySymbol
public String getInternationalCurrencySymbol()
- Возвращает:
- код валюты
- Начиная с версии:
- 1.2
setInternationalCurrencySymbol
public void setInternationalCurrencySymbol(String currencyCode)
Currency.getInstance), также задается атрибут валюты, которому присваивается соответствующий экземпляр Currency, и атрибут символа валюты, которому присваивается символ валюты в локали DecimalFormatSymbols. Если код валюты недопустим, атрибут валюты и атрибут символа валюты не изменяются.- Параметры:
-
currencyCode— код валюты - Вызывает исключение:
-
NullPointerException— еслиcurrencyCodeимеет значениеnull - Начиная с версии:
- 1.2
- См. также:
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
- См. также:
getMonetaryDecimalSeparator
public char getMonetaryDecimalSeparator()
- Возвращает:
- денежный десятичный разделитель
- Начиная с версии:
- 1.2
setMonetaryDecimalSeparator
public void setMonetaryDecimalSeparator(char sep)
- Параметры:
-
sep— денежный десятичный разделитель - Начиная с версии:
- 1.2
getExponentSeparator
public String getExponentSeparator()
- Возвращает:
- строка-разделитель экспоненты
- Начиная с версии:
- 1.6
- См. также:
setExponentSeparator
public void setExponentSeparator(String exp)
- Параметры:
-
exp— строка-разделитель экспоненты - Вызывает исключение:
-
NullPointerException— еслиexpимеет значение null - Начиная с версии:
- 1.6
- См. также:
getMonetaryGroupingSeparator
public char getMonetaryGroupingSeparator()
grouping separator, например для немецкого языка в Австрии.- Возвращает:
- денежный разделитель групп разрядов
- Начиная с версии:
- 15
setMonetaryGroupingSeparator
public void setMonetaryGroupingSeparator(char monetaryGroupingSeparator)
grouping separator.- Параметры:
-
monetaryGroupingSeparator— денежный разделитель групп разрядов - Начиная с версии:
- 15
- См. также:
clone
equals
public boolean equals(Object obj)
DecimalFormatSymbols на предмет равенства. Возвращает true, если объект также является DecimalFormatSymbols и оба объекта DecimalFormatSymbols представляют один и тот же набор символов.- Переопределяет:
-
equalsв классеObject - Требования к реализации:
- Этот метод проверяет равенство, определяя идентичность класса на основе
getClass(), а неinstanceof. Поэтому в методах equals подклассов ни один экземпляр этого класса не должен считаться равным экземпляру подкласса. - Параметры:
-
obj— объект для сравнения на равенство - Возвращает:
-
true, если указанный объект равен этомуDecimalFormatSymbols - См. также:
hashCode
public int hashCode()
DecimalFormatSymbols.- Переопределяет:
-
hashCodeв классеObject - Требования к реализации:
- Для вычисления значения хеш-кода используются нест transientные поля экземпляра этого класса; полученный код соответствует контракту, определенному в
Objects.hashCode(Object). - Возвращает:
- хеш-код этого
DecimalFormatSymbols - См. также:
© 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.