public abstract class TimeZoneNameProvider extends LocaleServiceProvider
TimeZoneNameProvider
provides localized
versions of the names that represent a particular
timezone. A null
value may
be returned, which should be treated as a lack of
support for the specified Locale
. The names
from this class are also used by
DateFormatSymbols#getZoneStrings()
.Modifier | Constructor and Description |
---|---|
protected |
TimeZoneNameProvider()
Constructs a new
TimeZoneNameProvider . |
Modifier and Type | Method and Description |
---|---|
abstract String |
getDisplayName(String id,
boolean daylight,
int style,
Locale locale)
Returns a name for the specified time zone identifier
localized to the supplied
Locale . |
getAvailableLocales
protected TimeZoneNameProvider()
TimeZoneNameProvider
.
Provided for implicit invocation by subclasses.public abstract String getDisplayName(String id, boolean daylight, int style, Locale locale)
Locale
.
The time zone identifier is either "GMT"
or one of the identifiers from the public domain "tz
database" found at
ftp://elsie.nci.nih.gov/pub. Note that a translated
name for the daylight savings time variant should be returned,
even if the timezone has not observed daylight savings
time in the past. If the name of the timezone
in the given locale is not supported, null
is returned.id
- a time zone identifier.daylight
- true if the daylight savings time variant
should be returned.style
- either java.util.TimeZone.LONG
or
java.util.TimeZone.SHORT
locale
- the locale to express the timezone in.null
if one is not available.NullPointerException
- if the identifer or locale is null.IllegalArgumentException
- if the style is invalid
or the locale is not one
returned by
LocaleServiceProvider.getAvailableLocales()
TimeZone.getDisplayName(boolean,int,java.util.Locale)