Class DateTimeFormatStyleProvider

  • Direct Known Subclasses:
    SimpleDateTimeFormatStyleProvider

    abstract class DateTimeFormatStyleProvider
    extends java.lang.Object
    The Service Provider Interface (SPI) to be implemented by classes providing date-time formatting information.

    Specification for implementors

    This interface is a service provider that can be called by multiple threads. Implementations must be thread-safe. Implementations should cache the returned formatters.
    • Constructor Detail

      • DateTimeFormatStyleProvider

        DateTimeFormatStyleProvider()
    • Method Detail

      • getAvailableLocales

        public java.util.Locale[] getAvailableLocales()
        Gets the available locales.
        Returns:
        the locales
      • getFormatter

        public abstract DateTimeFormatter getFormatter​(FormatStyle dateStyle,
                                                       FormatStyle timeStyle,
                                                       Chronology chrono,
                                                       java.util.Locale locale)
        Gets a localized date, time or date-time formatter.

        The formatter will be the most appropriate to use for the date and time style in the locale. For example, some locales will use the month name while others will use the number.

        Parameters:
        dateStyle - the date formatter style to obtain, null to obtain a time formatter
        timeStyle - the time formatter style to obtain, null to obtain a date formatter
        chrono - the chronology to use, not null
        locale - the locale to use, not null
        Returns:
        the date-time formatter, not null
        Throws:
        java.lang.IllegalArgumentException - if both format styles are null
        java.lang.IllegalArgumentException - if the locale is not a recognized locale