Класс 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 DecimalFormatSymbols getInstance()

Получает экземпляр DecimalFormatSymbols для локали по умолчанию.
static DecimalFormatSymbols getInstance​(Locale locale)

Получает экземпляр DecimalFormatSymbols для указанной локали.
String getInternationalCurrencySymbol()

Возвращает код валюты ISO 4217 для валюты этих DecimalFormatSymbols.
char getMinusSign()

Получает символ, используемый для представления минуса.
char getMonetaryDecimalSeparator()

Возвращает десятичный разделитель для денежных значений.
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 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.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()

Возвращает символ, используемый для представления знака минус. Если не указан явный отрицательный формат, он формируется путём добавления минусSign к положительному формату.

Возвращает:
символ, представляющий знак минус

setMinusSign

public void setMinusSign(char minusSign)

Устанавливает символ, используемый для представления знака минус. Если не указан явный отрицательный формат, он формируется путём добавления минусSign к положительному формату.

Параметры:
minusSign - символ, представляющий знак минус

getCurrencySymbol

public String getCurrencySymbol()

Возвращает символ валюты для валюты этих DecimalFormatSymbols в их языковом стандарте.

Возвращает:
символ валюты
С:
1.2

setCurrencySymbol

public void setCurrencySymbol(String currency)

Устанавливает символ валюты для валюты этих DecimalFormatSymbols в их языковом стандарте.

Параметры:
currency - символ валюты
С:
1.2

getInternationalCurrencySymbol

public String getInternationalCurrencySymbol()

Возвращает код валюты ISO 4217 для валюты этих DecimalFormatSymbols.

Возвращает:
код валюты
С:
1.2

setInternationalCurrencySymbol

public void setInternationalCurrencySymbol(String currencyCode)

Устанавливает код валюты ISO 4217 для валюты этих DecimalFormatSymbols. Если код валюты действителен (как определено в Currency.getInstance), это также устанавливает атрибут валюты на соответствующий экземпляр Currency и атрибут символа валюты на символ валюты в языковом стандарте DecimalFormatSymbols. Если код валюты не действителен, атрибут валюты устанавливается в null, а атрибут символа валюты не изменяется.

Параметры:
currencyCode - код валюты
С:
1.2
См. также:
setCurrency(java.util.Currency), setCurrencySymbol(java.lang.String)

getCurrency

public Currency getCurrency()

Получает валюту этих DecimalFormatSymbols. Может быть null, если ранее атрибут символа валюты был установлен на значение, не являющееся допустимым кодом валюты ISO 4217.

Возвращает:
используемая валюта или null
С:
1.4

setCurrency

public void setCurrency(Currency currency)

Устанавливает валюту этих DecimalFormatSymbols. Это также устанавливает атрибут символа валюты на символ валюты в языковом стандарте 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()

clone

public Object clone()

Стандартная перегрузка.

Переопределяет:
clone в классе Object
Возвращает:
клонированный экземпляр.
См. также:
Cloneable

equals

public boolean equals(Object obj)

Переопределенный equals.

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

hashCode

public int hashCode()

Переопределенный hashCode.

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

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

Spec-Zone .ru
спецификации, руководства, описания, API