java.lang.Object
java.util.spi.LocaleServiceProvider
java.util.spi.TimeZoneNameProvider
An abstract class for service providers that
provide localized time zone names for the
TimeZone class.
The localized time zone names available from the implementations of
this class are also the source for the
DateFormatSymbols.getZoneStrings() method.- Since:
- 1.6
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionabstract StringgetDisplayName(String ID, boolean daylight, int style, Locale locale) Returns a name for the given time zone ID that's suitable for presentation to the user in the specified locale.getGenericDisplayName(String ID, int style, Locale locale) Returns a generic name for the given time zoneIDthat's suitable for presentation to the user in the specifiedlocale.Methods declared in class java.util.spi.LocaleServiceProvider
getAvailableLocales, isSupportedLocale
-
Constructor Details
-
TimeZoneNameProvider
protected TimeZoneNameProvider()Sole constructor. (For invocation by subclass constructors, typically implicit.)
-
-
Method Details
-
getDisplayName
Returns a name for the given time zone ID that's suitable for presentation to the user in the specified locale. The given time zone ID is "GMT" or one of the names defined using "Zone" entries in the "tz database", a public domain time zone database at https://www.iana.org/time-zones. The data of this database is contained in a file whose name starts with "tzdata", and the specification of the data format is part of the zic.8 man page, which is contained in a file whose name starts with "tzcode".If
daylightis true, the method should return a name appropriate for daylight saving time even if the specified time zone has not observed daylight saving time in the past.- Parameters:
ID- a time zone ID stringdaylight- if true, return the daylight saving name.style- eitherTimeZone.LONGorTimeZone.SHORTlocale- the desired locale- Returns:
- the human-readable name of the given time zone in the given locale, or null if it's not available.
- Throws:
IllegalArgumentException- ifstyleis invalid, orlocaleisn't one of the locales returned fromgetAvailableLocales().NullPointerException- ifIDorlocaleis null- External Specifications
- See Also:
-
getGenericDisplayName
Returns a generic name for the given time zoneIDthat's suitable for presentation to the user in the specifiedlocale. Generic time zone names are neutral from standard time and daylight saving time. For example, "PT" is the short generic name of time zone IDAmerica/Los_Angeles, while its short standard time and daylight saving time names are "PST" and "PDT", respectively. Refer togetDisplayNamefor valid time zone IDs.The default implementation of this method returns
null.- Parameters:
ID- a time zone ID stringstyle- eitherTimeZone.LONGorTimeZone.SHORTlocale- the desired locale- Returns:
- the human-readable generic name of the given time zone in the
given locale, or
nullif it's not available. - Throws:
IllegalArgumentException- ifstyleis invalid, orlocaleisn't one of the locales returned fromgetAvailableLocales().NullPointerException- ifIDorlocaleisnull- Since:
- 1.8
-