Класс DecimalFormatSymbols

public class DecimalFormatSymbols
extends Object
implements Cloneable, Serializable

Конструкторы

DecimalFormatSymbols

public DecimalFormatSymbols()

См. также:

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.

С версии:

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 в их локали.

Возвращает:

символ валюты

С версии:

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)