java.text

Class 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 by 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.
    See Also:
    Locale, DecimalFormat, Serialized Form
    • 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 installed DecimalFormatSymbolsProvider implementations. For full locale coverage, use the getInstance 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 installed DecimalFormatSymbolsProvider implementations. For full locale coverage, use the getInstance method.
        Throws:
        NullPointerException - if locale is null
    • Method Detail

      • getAvailableLocales

        public static Locale[] getAvailableLocales()
        Returns an array of all locales for which the 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.
        Returns:
        An array of locales for which localized DecimalFormatSymbols instances are available.
        Since:
        1.6
      • getInstance

        public static final DecimalFormatSymbols getInstance()
        Gets the 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.
        Returns:
        a DecimalFormatSymbols instance.
        Since:
        1.6
      • getInstance

        public static final DecimalFormatSymbols getInstance(Locale locale)
        Gets the 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.
        Parameters:
        locale - the desired locale.
        Returns:
        a DecimalFormatSymbols instance.
        Throws:
        NullPointerException - if locale 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 by 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.
        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
      • 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 - if exp is null
        Since:
        1.6
        See Also:
        getExponentSeparator()
      • clone

        public Object clone()
        Standard override.
        Overrides:
        clone in class Object
        Returns:
        a clone of this instance.
        See Also:
        Cloneable
      • equals

        public boolean equals(Object obj)
        Override equals.
        Overrides:
        equals in class Object
        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

Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-java/text/DecimalFormatSymbols.html

The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.

References

  1. View the html document Language of the document:fr Manuel PHP : https://docs.oracle.com

These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.

Contents Haut