Module java.base

Class DecimalStyle


  • public final class DecimalStyle
    extends Object
    Localized decimal style used in date and time formatting.

    A significant part of dealing with dates and times is the localization. This class acts as a central point for accessing the information.

    Implementation Requirements:
    This class is immutable and thread-safe.
    Since:
    1.8
    • Field Detail

      • STANDARD

        public static final DecimalStyle STANDARD
        The standard set of non-localized decimal style symbols.

        This uses standard ASCII characters for zero, positive, negative and a dot for the decimal point.

    • Method Detail

      • getAvailableLocales

        public static Set<Locale> getAvailableLocales()
        Lists all the locales that are supported.

        The locale 'en_US' will always be present.

        Returns:
        a Set of Locales for which localization is supported
      • of

        public static DecimalStyle of​(Locale locale)
        Obtains the DecimalStyle for the specified locale.

        This method provides access to locale sensitive decimal style symbols. If the locale contains "nu" (Numbering System) and/or "rg" (Region Override) Unicode extensions, returned instance will reflect the values specified with those extensions. If both "nu" and "rg" are specified, the value from the "nu" extension supersedes the implicit one from the "rg" extension.

        Parameters:
        locale - the locale, not null
        Returns:
        the decimal style, not null
      • getZeroDigit

        public char getZeroDigit()
        Gets the character that represents zero.

        The character used to represent digits may vary by culture. This method specifies the zero character to use, which implies the characters for one to nine.

        Returns:
        the character for zero
      • withZeroDigit

        public DecimalStyle withZeroDigit​(char zeroDigit)
        Returns a copy of the info with a new character that represents zero.

        The character used to represent digits may vary by culture. This method specifies the zero character to use, which implies the characters for one to nine.

        Parameters:
        zeroDigit - the character for zero
        Returns:
        a copy with a new character that represents zero, not null
      • getPositiveSign

        public char getPositiveSign()
        Gets the character that represents the positive sign.

        The character used to represent a positive number may vary by culture. This method specifies the character to use.

        Returns:
        the character for the positive sign
      • withPositiveSign

        public DecimalStyle withPositiveSign​(char positiveSign)
        Returns a copy of the info with a new character that represents the positive sign.

        The character used to represent a positive number may vary by culture. This method specifies the character to use.

        Parameters:
        positiveSign - the character for the positive sign
        Returns:
        a copy with a new character that represents the positive sign, not null
      • getNegativeSign

        public char getNegativeSign()
        Gets the character that represents the negative sign.

        The character used to represent a negative number may vary by culture. This method specifies the character to use.

        Returns:
        the character for the negative sign
      • withNegativeSign

        public DecimalStyle withNegativeSign​(char negativeSign)
        Returns a copy of the info with a new character that represents the negative sign.

        The character used to represent a negative number may vary by culture. This method specifies the character to use.

        Parameters:
        negativeSign - the character for the negative sign
        Returns:
        a copy with a new character that represents the negative sign, not null
      • getDecimalSeparator

        public char getDecimalSeparator()
        Gets the character that represents the decimal point.

        The character used to represent a decimal point may vary by culture. This method specifies the character to use.

        Returns:
        the character for the decimal point
      • withDecimalSeparator

        public DecimalStyle withDecimalSeparator​(char decimalSeparator)
        Returns a copy of the info with a new character that represents the decimal point.

        The character used to represent a decimal point may vary by culture. This method specifies the character to use.

        Parameters:
        decimalSeparator - the character for the decimal point
        Returns:
        a copy with a new character that represents the decimal point, not null
      • equals

        public boolean equals​(Object obj)
        Checks if this DecimalStyle is equal to another DecimalStyle.
        Overrides:
        equals in class Object
        Parameters:
        obj - the object to check, null returns false
        Returns:
        true if this is equal to the other date
        See Also:
        Object.hashCode(), HashMap
      • toString

        public String toString()
        Returns a string describing this DecimalStyle.
        Overrides:
        toString in class Object
        Returns:
        a string description, not null