Класс DecimalFormatSymbols
- Все реализованные интерфейсы:
-
Serializable,Cloneable
public class DecimalFormatSymbols extends Object implements Cloneable, Serializable
DecimalFormat для форматирования чисел. DecimalFormat создаёт для себя экземпляр класса DecimalFormatSymbols из данных своего региона. Если вам нужно изменить любой из этих символов, вы можете получить объект DecimalFormatSymbols из своего объекта DecimalFormat и изменить его. Если в регионе содержится расширение «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 |
Устанавливает символ, используемый для обозначения нуля. |
Подробное описание конструкторов
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()
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 соответствующему объекту Currency и атрибут currency symbol к символу валюты в локали DecimalFormatSymbols. Если код валюты некорректен, атрибут currency и атрибут currency symbol не изменяются.- Параметры:
-
currencyCode- код валюты - Издаёт исключение:
-
NullPointerException- еслиcurrencyCodeравноnull - С тех пор как:
- 1.2
- См. также:
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
- См. также:
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 - Требования к реализации:
- Не-транзиентные поля экземпляра этого класса используются для вычисления значения хеш-кода, которое соответствует контракту, определенному в
Objects.hashCode(java.lang.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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/text/DecimalFormatSymbols.html