Serializable
, Cloneable
public class DecimalFormatSymbols extends Object implements Cloneable, Serializable
DecimalFormat
to format numbers. DecimalFormat
creates for itself an instance of DecimalFormatSymbols
from its locale data. If you need to change any of these symbols, you can get the DecimalFormatSymbols
object from your DecimalFormat
and modify it. If the locale contains "rg" (region override) Unicode extension, the symbols are overridden for the designated region.
Constructor | Description |
---|---|
DecimalFormatSymbols() |
Create a DecimalFormatSymbols object for the default FORMAT locale. |
DecimalFormatSymbols |
Create a DecimalFormatSymbols object for the given locale. |
Modifier and Type | Method | Description |
---|---|---|
Object |
clone() |
Standard override. |
boolean |
equals |
Override equals. |
static Locale[] |
getAvailableLocales() |
Returns an array of all locales for which the getInstance methods of this class can return localized instances. |
Currency |
getCurrency() |
Gets the currency of these DecimalFormatSymbols. |
String |
getCurrencySymbol() |
Returns the currency symbol for the currency of these DecimalFormatSymbols in their locale. |
char |
getDecimalSeparator() |
Gets the character used for decimal sign. |
char |
getDigit() |
Gets the character used for a digit in a pattern. |
String |
getExponentSeparator() |
Returns the string used to separate the mantissa from the exponent. |
char |
getGroupingSeparator() |
Gets the character used for grouping separator. |
String |
getInfinity() |
Gets the string used to represent infinity. |
static final DecimalFormatSymbols |
getInstance() |
Gets the DecimalFormatSymbols instance for the default locale. |
static final DecimalFormatSymbols |
getInstance |
Gets the DecimalFormatSymbols instance for the specified locale. |
String |
getInternationalCurrencySymbol() |
Returns the ISO 4217 currency code of the currency of these DecimalFormatSymbols. |
Locale |
getLocale() |
Returns locale used to create this instance. |
char |
getMinusSign() |
Gets the character used to represent minus sign. |
char |
getMonetaryDecimalSeparator() |
Returns the monetary decimal separator. |
char |
getMonetaryGroupingSeparator() |
Gets the character used for grouping separator for currencies. |
String |
getNaN() |
Gets the string used to represent "not a number". |
char |
getPatternSeparator() |
Gets the character used to separate positive and negative subpatterns in a pattern. |
char |
getPercent() |
Gets the character used for percent sign. |
char |
getPerMill() |
Gets the character used for per mille sign. |
char |
getZeroDigit() |
Gets the character used for zero. |
int |
hashCode() |
Override hashCode. |
void |
setCurrency |
Sets the currency of these DecimalFormatSymbols. |
void |
setCurrencySymbol |
Sets the currency symbol for the currency of these DecimalFormatSymbols in their locale. |
void |
setDecimalSeparator |
Sets the character used for decimal sign. |
void |
setDigit |
Sets the character used for a digit in a pattern. |
void |
setExponentSeparator |
Sets the string used to separate the mantissa from the exponent. |
void |
setGroupingSeparator |
Sets the character used for grouping separator. |
void |
setInfinity |
Sets the string used to represent infinity. |
void |
setInternationalCurrencySymbol |
Sets the ISO 4217 currency code of the currency of these DecimalFormatSymbols. |
void |
setMinusSign |
Sets the character used to represent minus sign. |
void |
setMonetaryDecimalSeparator |
Sets the monetary decimal separator. |
void |
setMonetaryGroupingSeparator |
Sets the character used for grouping separator for currencies. |
void |
setNaN |
Sets the string used to represent "not a number". |
void |
setPatternSeparator |
Sets the character used to separate positive and negative subpatterns in a pattern. |
void |
setPercent |
Sets the character used for percent sign. |
void |
setPerMill |
Sets the character used for per mille sign. |
void |
setZeroDigit |
Sets the character used for zero. |
public DecimalFormatSymbols()
FORMAT
locale. This constructor can only construct instances for the locales supported by the Java runtime environment, not for those supported by installed DecimalFormatSymbolsProvider
implementations. For full locale coverage, use the getInstance
method. This is equivalent to calling DecimalFormatSymbols(Locale.getDefault(Locale.Category.FORMAT))
.
public DecimalFormatSymbols(Locale locale)
DecimalFormatSymbolsProvider
implementations. For full locale coverage, use the getInstance
method. If the specified locale contains the Locale.UNICODE_LOCALE_EXTENSION
for the numbering system, the instance is initialized with the specified numbering system if the JRE implementation supports it. For example, NumberFormat.getNumberInstance(Locale.forLanguageTag("th-TH-u-nu-thai"))This may return a
NumberFormat
instance with the Thai numbering system, instead of the Latin numbering system.locale
- the desired localeNullPointerException
- if locale
is nullpublic static Locale[] getAvailableLocales()
getInstance
methods of this class can return localized instances. The returned array represents the union of locales supported by the Java runtime and by installed DecimalFormatSymbolsProvider
implementations. At a minimum, the returned array must contain a Locale
instance equal to Locale.ROOT
and a Locale
instance equal to Locale.US
.DecimalFormatSymbols
instances are available.public static final DecimalFormatSymbols getInstance()
DecimalFormatSymbols
instance for the default locale. This method provides access to DecimalFormatSymbols
instances for locales supported by the Java runtime itself as well as for those supported by installed DecimalFormatSymbolsProvider
implementations. This is equivalent to calling getInstance(Locale.getDefault(Locale.Category.FORMAT))
.
DecimalFormatSymbols
instance.public static final DecimalFormatSymbols getInstance(Locale locale)
DecimalFormatSymbols
instance for the specified locale. This method provides access to DecimalFormatSymbols
instances for locales supported by the Java runtime itself as well as for those supported by installed DecimalFormatSymbolsProvider
implementations. If the specified locale contains the Locale.UNICODE_LOCALE_EXTENSION
for the numbering system, the instance is initialized with the specified numbering system if the JRE implementation supports it. For example, NumberFormat.getNumberInstance(Locale.forLanguageTag("th-TH-u-nu-thai"))This may return a
NumberFormat
instance with the Thai numbering system, instead of the Latin numbering system.locale
- the desired locale.DecimalFormatSymbols
instance.NullPointerException
- if locale
is nullpublic Locale getLocale()
public char getZeroDigit()
public void setZeroDigit(char zeroDigit)
zeroDigit
- the character used for zeropublic char getGroupingSeparator()
public void setGroupingSeparator(char groupingSeparator)
groupingSeparator
- the grouping separatorpublic char getDecimalSeparator()
public void setDecimalSeparator(char decimalSeparator)
decimalSeparator
- the character used for decimal signpublic char getPerMill()
public void setPerMill(char perMill)
perMill
- the character used for per mille signpublic char getPercent()
public void setPercent(char percent)
percent
- the character used for percent signpublic char getDigit()
public void setDigit(char digit)
digit
- the character used for a digit in a patternpublic char getPatternSeparator()
public void setPatternSeparator(char patternSeparator)
patternSeparator
- the pattern separatorpublic String getInfinity()
public void setInfinity(String infinity)
infinity
- the string representing infinitypublic String getNaN()
public void setNaN(String NaN)
NaN
- the string representing "not a number"public char getMinusSign()
public void setMinusSign(char minusSign)
minusSign
- the character representing minus signpublic String getCurrencySymbol()
public void setCurrencySymbol(String currency)
currency
- the currency symbolpublic String getInternationalCurrencySymbol()
public void setInternationalCurrencySymbol(String currencyCode)
Currency.getInstance
), this also sets the currency attribute to the corresponding Currency instance and the currency symbol attribute to the currency's symbol in the DecimalFormatSymbols' locale. If the currency code is not valid, then the currency attribute is set to null and the currency symbol attribute is not modified.currencyCode
- the currency codepublic Currency getCurrency()
public void setCurrency(Currency currency)
currency
- the new currency to be usedNullPointerException
- if currency
is nullpublic char getMonetaryDecimalSeparator()
public void setMonetaryDecimalSeparator(char sep)
sep
- the monetary decimal separatorpublic String getExponentSeparator()
public void setExponentSeparator(String exp)
exp
- the exponent separator stringNullPointerException
- if exp
is nullpublic char getMonetaryGroupingSeparator()
grouping separator
in some locales, e.g, German in Austria.public void setMonetaryGroupingSeparator(char monetaryGroupingSeparator)
grouping separator
.monetaryGroupingSeparator
- the monetary grouping separatorpublic Object clone()
public boolean equals(Object obj)
public int hashCode()
© 1993, 2023, 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/21/docs/api/java.base/java/text/DecimalFormatSymbols.html