Класс DecimalFormatSymbols
- Все реализуемые интерфейсы:
Serializable, Cloneable
public class DecimalFormatSymbols extends Object implements Cloneable, Serializable
DecimalFormat для форматирования чисел. DecimalFormat создает для себя экземпляр DecimalFormatSymbols на основе данных локали. Если требуется изменить какие-либо из этих символов, можно получить объект DecimalFormatSymbols из своего DecimalFormat и изменить его. Если локаль содержит расширение Unicode "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()
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 - Требования к реализации:
- Для вычисления значения хеш-кода используются нетранзиентные поля экземпляра этого класса. Полученное значение соответствует контракту, определенному в
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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/text/DecimalFormatSymbols.html