Class DateTimeFormatSymbols


  • public final class DateTimeFormatSymbols
    extends Object
    Symbols used for date and time formatting.
    Author:
    Stephen Colebourne
    • 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 DateTimeFormatSymbolsProvider implementations. It must contain at least a Locale instance equal to Locale.US.
        Returns:
        an array of locales for which localized DateTimeFormatSymbols instances are available
      • getInstance

        public static DateTimeFormatSymbols getInstance()
        Gets the DateFormatSymbols instance for the default locale. This method provides access to DateFormatSymbols instances for locales supported by the Java runtime itself as well as for those supported by installed DateFormatSymbolsProvider implementations.
        Returns:
        a DateTimeFormatSymbols instance.
      • getInstance

        public static DateTimeFormatSymbols getInstance​(Locale locale)
        Gets the DateFormatSymbols instance for the specified locale. This method provides access to DateFormatSymbols instances for locales supported by the Java runtime itself as well as for those supported by installed DateFormatSymbolsProvider implementations.
        Parameters:
        locale - the given locale, not null
        Returns:
        a DateTimeFormatSymbols instance
        Throws:
        NullPointerException - if locale is null
      • getLocale

        public Locale getLocale()
        Gets the locale to use for printing and parsing text.

        The locale information for printing and parsing numbers is defined in the zero, negative and positive characters.

        Returns:
        the character for zero
      • getZeroChar

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

        This character can vary by locale.

        Returns:
        the character for zero
      • getDigitChar

        public char getDigitChar​(int digit)
        Gets the character that represents the specified digit.

        This character can vary by locale. The characters for one to nine are based on the stored zero character.

        Parameters:
        digit - the single digit to convert to a character, from 0 to 9
        Returns:
        the character for the digit
      • convertToDigit

        public int convertToDigit​(char ch)
        Checks whether the character is a digit, based on the currently set zero character.
        Parameters:
        ch - the character to check
        Returns:
        the value, 0 to 9, of the character, or -1 if not a digit
      • getPositiveSignChar

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

        This character can vary by locale.

        Returns:
        the character for the positive sign
      • getNegativeSignChar

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

        This character can vary by locale.

        Returns:
        the character for the negative sign
      • getDecimalPointChar

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

        This character can vary by locale.

        Returns:
        the character for the decimal point