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.Locale,
DecimalFormat,
Serialized Form| Constructor and Description |
|---|
DecimalFormatSymbols()
Create a DecimalFormatSymbols object for the default
FORMAT locale. |
DecimalFormatSymbols(Locale locale)
Create a DecimalFormatSymbols object for the given locale.
|
| Modifier and Type | Method and Description |
|---|---|
Object |
clone()
Standard override.
|
boolean |
equals(Object obj)
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 thousands separator.
|
String |
getInfinity()
Gets the string used to represent infinity.
|
static DecimalFormatSymbols |
getInstance()
Gets the
DecimalFormatSymbols instance for the default
locale. |
static DecimalFormatSymbols |
getInstance(Locale locale)
Gets the
DecimalFormatSymbols instance for the specified
locale. |
String |
getInternationalCurrencySymbol()
Returns the ISO 4217 currency code of the currency of these
DecimalFormatSymbols.
|
char |
getMinusSign()
Gets the character used to represent minus sign.
|
char |
getMonetaryDecimalSeparator()
Returns the monetary decimal separator.
|
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(Currency currency)
Sets the currency of these DecimalFormatSymbols.
|
void |
setCurrencySymbol(String currency)
Sets the currency symbol for the currency of these
DecimalFormatSymbols in their locale.
|
void |
setDecimalSeparator(char decimalSeparator)
Sets the character used for decimal sign.
|
void |
setDigit(char digit)
Sets the character used for a digit in a pattern.
|
void |
setExponentSeparator(String exp)
Sets the string used to separate the mantissa from the exponent.
|
void |
setGroupingSeparator(char groupingSeparator)
Sets the character used for thousands separator.
|
void |
setInfinity(String infinity)
Sets the string used to represent infinity.
|
void |
setInternationalCurrencySymbol(String currencyCode)
Sets the ISO 4217 currency code of the currency of these
DecimalFormatSymbols.
|
void |
setMinusSign(char minusSign)
Sets the character used to represent minus sign.
|
void |
setMonetaryDecimalSeparator(char sep)
Sets the monetary decimal separator.
|
void |
setNaN(String NaN)
Sets the string used to represent "not a number".
|
void |
setPatternSeparator(char patternSeparator)
Sets the character used to separate positive and negative subpatterns
in a pattern.
|
void |
setPercent(char percent)
Sets the character used for percent sign.
|
void |
setPerMill(char perMill)
Sets the character used for per mille sign.
|
void |
setZeroDigit(char zeroDigit)
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. It must contain at least 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.Locale.getDefault(java.util.Locale.Category),
Locale.Category.FORMATpublic 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 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 codesetCurrency(java.util.Currency),
setCurrencySymbol(java.lang.String)public Currency getCurrency()
public void setCurrency(Currency currency)
currency - the new currency to be usedNullPointerException - if currency is nullsetCurrencySymbol(java.lang.String),
setInternationalCurrencySymbol(java.lang.String)public char getMonetaryDecimalSeparator()
public void setMonetaryDecimalSeparator(char sep)
sep - the monetary decimal separatorpublic String getExponentSeparator()
setExponentSeparator(java.lang.String)public void setExponentSeparator(String exp)
exp - the exponent separator stringNullPointerException - if exp is nullgetExponentSeparator()public Object clone()
public boolean equals(Object obj)
equals in class Objectobj - the reference object with which to compare.true if this object is the same as the obj
argument; false otherwise.Object.hashCode(),
HashMappublic int hashCode()
hashCode in class ObjectObject.equals(java.lang.Object),
System.identityHashCode(java.lang.Object) Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2017, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.