public abstract class TimeZoneNameProvider extends LocaleServiceProvider
TimeZone
class. The localized time zone names available from the implementations of this class are also the source for the DateFormatSymbols.getZoneStrings()
method.Modifier | Constructor | Description |
---|---|---|
protected |
Sole constructor. |
Modifier and Type | Method | Description |
---|---|---|
abstract String |
getDisplayName |
Returns a name for the given time zone ID that's suitable for presentation to the user in the specified locale. |
String |
getGenericDisplayName |
Returns a generic name for the given time zone ID that's suitable for presentation to the user in the specified locale . |
getAvailableLocales, isSupportedLocale
protected TimeZoneNameProvider()
public abstract String getDisplayName(String ID, boolean daylight, int style, Locale locale)
If daylight
is 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.
ID
- a time zone ID stringdaylight
- if true, return the daylight saving name.style
- either TimeZone.LONG
or TimeZone.SHORT
locale
- the desired localeIllegalArgumentException
- if style
is invalid, or locale
isn't one of the locales returned from getAvailableLocales()
.NullPointerException
- if ID
or locale
is nullpublic String getGenericDisplayName(String ID, int style, Locale locale)
ID
that's suitable for presentation to the user in the specified locale
. Generic time zone names are neutral from standard time and daylight saving time. For example, "PT" is the short generic name of time zone ID
America/Los_Angeles
, while its short standard time and daylight saving time names are "PST" and "PDT", respectively. Refer to getDisplayName
for valid time zone IDs. The default implementation of this method returns null
.
ID
- a time zone ID stringstyle
- either TimeZone.LONG
or TimeZone.SHORT
locale
- the desired localenull
if it's not available.IllegalArgumentException
- if style
is invalid, or locale
isn't one of the locales returned from getAvailableLocales()
.NullPointerException
- if ID
or locale
is null
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/spi/TimeZoneNameProvider.html