- java.lang.Object
-
- java.text.DecimalFormatSymbols
-
- All Implemented Interfaces:
- Serializable, Cloneable
public class DecimalFormatSymbols extends Object implements Cloneable, Serializable
This class represents the set of symbols (such as the decimal separator, the grouping separator, and so on) needed byDecimalFormat
to format numbers.DecimalFormat
creates for itself an instance ofDecimalFormatSymbols
from its locale data. If you need to change any of these symbols, you can get theDecimalFormatSymbols
object from yourDecimalFormat
and modify it.- See Also:
Locale
,DecimalFormat
, Serialized Form
-
-
Constructor Summary
Constructors Constructor and Description DecimalFormatSymbols()
Create a DecimalFormatSymbols object for the default locale.DecimalFormatSymbols(Locale locale)
Create a DecimalFormatSymbols object for the given locale.
-
Method Summary
Methods 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 thegetInstance
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 theDecimalFormatSymbols
instance for the default locale.static DecimalFormatSymbols
getInstance(Locale locale)
Gets theDecimalFormatSymbols
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.
-
-
-
Constructor Detail
-
DecimalFormatSymbols
public DecimalFormatSymbols()
Create a DecimalFormatSymbols object for the default locale. This constructor can only construct instances for the locales supported by the Java runtime environment, not for those supported by installedDecimalFormatSymbolsProvider
implementations. For full locale coverage, use thegetInstance
method.
-
DecimalFormatSymbols
public DecimalFormatSymbols(Locale locale)
Create a DecimalFormatSymbols object for the given locale. This constructor can only construct instances for the locales supported by the Java runtime environment, not for those supported by installedDecimalFormatSymbolsProvider
implementations. For full locale coverage, use thegetInstance
method.- Throws:
NullPointerException
- iflocale
is null
-
-
Method Detail
-
getAvailableLocales
public static Locale[] getAvailableLocales()
Returns an array of all locales for which thegetInstance
methods of this class can return localized instances. The returned array represents the union of locales supported by the Java runtime and by installedDecimalFormatSymbolsProvider
implementations. It must contain at least aLocale
instance equal toLocale.US
.- Returns:
- An array of locales for which localized
DecimalFormatSymbols
instances are available. - Since:
- 1.6
-
getInstance
public static final DecimalFormatSymbols getInstance()
Gets theDecimalFormatSymbols
instance for the default locale. This method provides access toDecimalFormatSymbols
instances for locales supported by the Java runtime itself as well as for those supported by installedDecimalFormatSymbolsProvider
implementations.- Returns:
- a
DecimalFormatSymbols
instance. - Since:
- 1.6
-
getInstance
public static final DecimalFormatSymbols getInstance(Locale locale)
Gets theDecimalFormatSymbols
instance for the specified locale. This method provides access toDecimalFormatSymbols
instances for locales supported by the Java runtime itself as well as for those supported by installedDecimalFormatSymbolsProvider
implementations.- Parameters:
locale
- the desired locale.- Returns:
- a
DecimalFormatSymbols
instance. - Throws:
NullPointerException
- iflocale
is null- Since:
- 1.6
-
getZeroDigit
public char getZeroDigit()
Gets the character used for zero. Different for Arabic, etc.
-
setZeroDigit
public void setZeroDigit(char zeroDigit)
Sets the character used for zero. Different for Arabic, etc.
-
getGroupingSeparator
public char getGroupingSeparator()
Gets the character used for thousands separator. Different for French, etc.
-
setGroupingSeparator
public void setGroupingSeparator(char groupingSeparator)
Sets the character used for thousands separator. Different for French, etc.
-
getDecimalSeparator
public char getDecimalSeparator()
Gets the character used for decimal sign. Different for French, etc.
-
setDecimalSeparator
public void setDecimalSeparator(char decimalSeparator)
Sets the character used for decimal sign. Different for French, etc.
-
getPerMill
public char getPerMill()
Gets the character used for per mille sign. Different for Arabic, etc.
-
setPerMill
public void setPerMill(char perMill)
Sets the character used for per mille sign. Different for Arabic, etc.
-
getPercent
public char getPercent()
Gets the character used for percent sign. Different for Arabic, etc.
-
setPercent
public void setPercent(char percent)
Sets the character used for percent sign. Different for Arabic, etc.
-
getDigit
public char getDigit()
Gets the character used for a digit in a pattern.
-
setDigit
public void setDigit(char digit)
Sets the character used for a digit in a pattern.
-
getPatternSeparator
public char getPatternSeparator()
Gets the character used to separate positive and negative subpatterns in a pattern.
-
setPatternSeparator
public void setPatternSeparator(char patternSeparator)
Sets the character used to separate positive and negative subpatterns in a pattern.
-
getInfinity
public String getInfinity()
Gets the string used to represent infinity. Almost always left unchanged.
-
setInfinity
public void setInfinity(String infinity)
Sets the string used to represent infinity. Almost always left unchanged.
-
getNaN
public String getNaN()
Gets the string used to represent "not a number". Almost always left unchanged.
-
setNaN
public void setNaN(String NaN)
Sets the string used to represent "not a number". Almost always left unchanged.
-
getMinusSign
public char getMinusSign()
Gets the character used to represent minus sign. If no explicit negative format is specified, one is formed by prefixing minusSign to the positive format.
-
setMinusSign
public void setMinusSign(char minusSign)
Sets the character used to represent minus sign. If no explicit negative format is specified, one is formed by prefixing minusSign to the positive format.
-
getCurrencySymbol
public String getCurrencySymbol()
Returns the currency symbol for the currency of these DecimalFormatSymbols in their locale.- Since:
- 1.2
-
setCurrencySymbol
public void setCurrencySymbol(String currency)
Sets the currency symbol for the currency of these DecimalFormatSymbols in their locale.- Since:
- 1.2
-
getInternationalCurrencySymbol
public String getInternationalCurrencySymbol()
Returns the ISO 4217 currency code of the currency of these DecimalFormatSymbols.- Since:
- 1.2
-
setInternationalCurrencySymbol
public void setInternationalCurrencySymbol(String currencyCode)
Sets the ISO 4217 currency code of the currency of these DecimalFormatSymbols. If the currency code is valid (as defined byCurrency.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.- Since:
- 1.2
- See Also:
setCurrency(java.util.Currency)
,setCurrencySymbol(java.lang.String)
-
getCurrency
public Currency getCurrency()
Gets the currency of these DecimalFormatSymbols. May be null if the currency symbol attribute was previously set to a value that's not a valid ISO 4217 currency code.- Returns:
- the currency used, or null
- Since:
- 1.4
-
setCurrency
public void setCurrency(Currency currency)
Sets the currency of these DecimalFormatSymbols. This also sets the currency symbol attribute to the currency's symbol in the DecimalFormatSymbols' locale, and the international currency symbol attribute to the currency's ISO 4217 currency code.- Parameters:
currency
- the new currency to be used- Throws:
NullPointerException
- ifcurrency
is null- Since:
- 1.4
- See Also:
setCurrencySymbol(java.lang.String)
,setInternationalCurrencySymbol(java.lang.String)
-
getMonetaryDecimalSeparator
public char getMonetaryDecimalSeparator()
Returns the monetary decimal separator.- Since:
- 1.2
-
setMonetaryDecimalSeparator
public void setMonetaryDecimalSeparator(char sep)
Sets the monetary decimal separator.- Since:
- 1.2
-
getExponentSeparator
public String getExponentSeparator()
Returns the string used to separate the mantissa from the exponent. Examples: "x10^" for 1.23x10^4, "E" for 1.23E4.- Returns:
- the exponent separator string
- Since:
- 1.6
- See Also:
setExponentSeparator(java.lang.String)
-
setExponentSeparator
public void setExponentSeparator(String exp)
Sets the string used to separate the mantissa from the exponent. Examples: "x10^" for 1.23x10^4, "E" for 1.23E4.- Parameters:
exp
- the exponent separator string- Throws:
NullPointerException
- ifexp
is null- Since:
- 1.6
- See Also:
getExponentSeparator()
-
clone
public Object clone()
Standard override.
-
equals
public boolean equals(Object obj)
Override equals.- Overrides:
equals
in classObject
- Parameters:
obj
- the reference object with which to compare.- Returns:
true
if this object is the same as the obj argument;false
otherwise.- See Also:
Object.hashCode()
,HashMap
-
hashCode
public int hashCode()
Override hashCode.- Overrides:
hashCode
in classObject
- Returns:
- a hash code value for this object.
- See Also:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-java/text/decimalformatsymbols.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.