Spec-Zone.ru › OpenJDK 17

Класс 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)
Переопределение equals.
static Locale[] getAvailableLocales()
Возвращает массив всех локалей, для которых методы getInstance этого класса могут возвращать локализованные экземпляры.
Currency getCurrency()
Получает валюту этих 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.
char getMinusSign()
Получает символ, используемый для представления минуса.
char getMonetaryDecimalSeparator()
Возвращает денечный разделитель десятичных знаков.
char getMonetaryGroupingSeparator()
Получает символ, используемый для разделителя группировки для валют.
String getNaN()
Получает строку, используемую для представления «не число».
char getPatternSeparator()
Получает символ, используемый для разделения положительных и отрицательных подшаблонов в шаблоне.
char getPercent()
Получает символ, используемый для знака процента.
char getPerMill()
Получает символ, используемый для знака промилле.
char getZeroDigit()
Получает символ, используемый для нуля.
int hashCode()
Переопределение hashCode.
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)
Устанавливает символ, используемый для нуля.

Методы, объявленные в классе 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()
Возвращает массив всех локалей, для которых методы getInstance этого класса могут возвращать локализованные экземпляры. Возвращаемый массив представляет собой объединение локалей, поддерживаемых средой выполнения Java и установленными реализациями DecimalFormatSymbolsProvider. Он должен содержать как минимум экземпляр 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

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 - строка, представляющая бесконечность

getNaN

public String getNaN()
Возвращает строку, используемую для представления «не число». Почти всегда остается неизменной.
Возвращает:
строка, представляющая «не число»

setNaN

public void setNaN(String NaN)
Устанавливает строку, используемую для представления «не число». Почти всегда остается неизменной.
Параметры:
NaN - строка, представляющая «не число»

getMinusSign

public char getMinusSign()
Возвращает символ, используемый для представления знака минус. Если не указан явный отрицательный формат, он формируется путем добавления minusSign к положительному формату.
Возвращает:
символ, представляющий знак минус

setMinusSign

public void setMinusSign(char minusSign)
Устанавливает символ, используемый для представления знака минус. Если не указан явный отрицательный формат, он формируется путем добавления minusSign к положительному формату.
Параметры:
minusSign - символ, представляющий знак минус

getCurrencySymbol

public String getCurrencySymbol()
Возвращает символ валюты для валюты этих DecimalFormatSymbols в их локали.
Возвращает:
символ валюты
Since:
1.2

setCurrencySymbol

public void setCurrencySymbol(String currency)
Устанавливает символ валюты для валюты этих DecimalFormatSymbols в их локали.
Параметры:
currency - символ валюты
Since:
1.2

getInternationalCurrencySymbol

public String getInternationalCurrencySymbol()
Возвращает код валюты ISO 4217 для валюты этих DecimalFormatSymbols.
Возвращает:
код валюты
Since:
1.2

setInternationalCurrencySymbol

public void setInternationalCurrencySymbol(String currencyCode)
Устанавливает код валюты ISO 4217 для валюты этих DecimalFormatSymbols. Если код валюты является корректным (как определено в Currency.getInstance), это также устанавливает атрибут currency соответствующему экземпляру Currency и атрибут currency symbol к символу валюты в локали DecimalFormatSymbols. Если код валюты не корректный, то атрибут currency устанавливается в null, а атрибут currency symbol не изменяется.
Параметры:
currencyCode - код валюты
Since:
1.2
См. также:
  • setCurrency(java.util.Currency)
  • setCurrencySymbol(java.lang.String)

getCurrency

public Currency getCurrency()
Получает валюту этих DecimalFormatSymbols. Может быть null, если атрибут currency symbol был ранее установлен на значение, которое не является корректным кодом валюты ISO 4217.
Возвращает:
используемая валюта, или null
Since:
1.4

setCurrency

public void setCurrency(Currency currency)
Устанавливает валюту этих DecimalFormatSymbols. Это также устанавливает атрибут currency symbol на символ валюты в локали DecimalFormatSymbols, и атрибут international currency symbol на код валюты ISO 4217.
Параметры:
currency - новая валюта для использования
Исключения:
NullPointerException - если currency равно null
Since:
1.4
См. также:
  • setCurrencySymbol(java.lang.String)
  • setInternationalCurrencySymbol(java.lang.String)

getMonetaryDecimalSeparator

public char getMonetaryDecimalSeparator()
Возвращает десятичный разделитель для валют.
Возвращает:
десятичный разделитель для валют
Since:
1.2

setMonetaryDecimalSeparator

public void setMonetaryDecimalSeparator(char sep)
Устанавливает десятичный разделитель для валют.
Параметры:
sep - десятичный разделитель для валют
Since:
1.2

getExponentSeparator

public String getExponentSeparator()
Возвращает строку, используемую для разделения мантиссы и экспоненты. Примеры: "x10^" для 1.23x10^4, "E" для 1.23E4.
Возвращает:
строку-разделитель экспоненты
Since:
1.6
См. также:
  • setExponentSeparator(java.lang.String)

setExponentSeparator

public void setExponentSeparator(String exp)
Устанавливает строку, используемую для разделения мантиссы и экспоненты. Примеры: "x10^" для 1.23x10^4, "E" для 1.23E4.
Параметры:
exp - строку-разделитель экспоненты
Исключения:
NullPointerException - если exp равно null
Since:
1.6
См. также:
  • getExponentSeparator()

getMonetaryGroupingSeparator

public char getMonetaryGroupingSeparator()
Возвращает символ, используемый для разделителя группировки для валют. Может отличаться от grouping separator в некоторых локалиях, например, немецкой в Австрии.
Возвращает:
разделитель группировки для валют
Since:
15

setMonetaryGroupingSeparator

public void setMonetaryGroupingSeparator(char monetaryGroupingSeparator)
Устанавливает символ, используемый для разделителя группировки для валют. Вызов этого метода не повлияет на обычный grouping separator.
Параметры:
monetaryGroupingSeparator - разделитель группировки для валют
Since:
15
См. также:
  • setGroupingSeparator(char)

clone

public Object clone()
Стандартная перегрузка.
Overrides:
clone в классе Object
Возвращает:
клонированный экземпляр.
См. также:
  • Cloneable

equals

public boolean equals(Object obj)
Переопределение equals.
Overrides:
equals в классе Object
Параметры:
obj - объект-ссылка для сравнения.
Возвращает:
true если этот объект такой же, как аргумент obj; false в противном случае.
См. также:
  • Object.hashCode()
  • HashMap

hashCode

public int hashCode()
Переопределение hashCode.
Overrides:
hashCode в классе Object
Возвращает:
значение хэш-кода для этого объекта.
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(java.lang.Object)

© 1993, 2021, 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/17/docs/api/java.base/java/text/DecimalFormatSymbols.html

Spec-Zone.ru

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