598 lines
23 KiB
Java
598 lines
23 KiB
Java
|
/* GENERATED SOURCE. DO NOT MODIFY. */
|
||
|
|
// © 2016 and later: Unicode, Inc. and others.
|
||
|
|
// License & terms of use: http://www.unicode.org/copyright.html
|
||
|
|
/*
|
||
|
|
*******************************************************************************
|
||
|
|
* Copyright (C) 2011-2016, International Business Machines Corporation and
|
||
|
|
* others. All Rights Reserved.
|
||
|
|
*******************************************************************************
|
||
|
|
*/
|
||
|
|
package android.icu.text;
|
||
|
|
|
||
|
|
import java.io.Serializable;
|
||
|
|
import java.util.Collection;
|
||
|
|
import java.util.Collections;
|
||
|
|
import java.util.EnumSet;
|
||
|
|
import java.util.Locale;
|
||
|
|
import java.util.Set;
|
||
|
|
|
||
|
|
import android.icu.impl.ICUConfig;
|
||
|
|
import android.icu.impl.SoftCache;
|
||
|
|
import android.icu.impl.TZDBTimeZoneNames;
|
||
|
|
import android.icu.impl.TimeZoneNamesImpl;
|
||
|
|
import android.icu.util.TimeZone;
|
||
|
|
import android.icu.util.ULocale;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* <code>TimeZoneNames</code> is an abstract class representing the time zone display name data model defined
|
||
|
|
* by <a href="http://www.unicode.org/reports/tr35/">UTS#35 Unicode Locale Data Markup Language (LDML)</a>.
|
||
|
|
* The model defines meta zone, which is used for storing a set of display names. A meta zone can be shared
|
||
|
|
* by multiple time zones. Also a time zone may have multiple meta zone historic mappings.
|
||
|
|
* <p>
|
||
|
|
* For example, people in the United States refer the zone used by the east part of North America as "Eastern Time".
|
||
|
|
* The tz database contains multiple time zones "America/New_York", "America/Detroit", "America/Montreal" and some
|
||
|
|
* others that belong to "Eastern Time". However, assigning different display names to these time zones does not make
|
||
|
|
* much sense for most of people.
|
||
|
|
* <p>
|
||
|
|
* In <a href="http://cldr.unicode.org/">CLDR</a> (which uses LDML for representing locale data), the display name
|
||
|
|
* "Eastern Time" is stored as long generic display name of a meta zone identified by the ID "America_Eastern".
|
||
|
|
* Then, there is another table maintaining the historic mapping to meta zones for each time zone. The time zones in
|
||
|
|
* the above example ("America/New_York", "America/Detroit"...) are mapped to the meta zone "America_Eastern".
|
||
|
|
* <p>
|
||
|
|
* Sometimes, a time zone is mapped to a different time zone in the past. For example, "America/Indiana/Knox"
|
||
|
|
* had been moving "Eastern Time" and "Central Time" back and forth. Therefore, it is necessary that time zone
|
||
|
|
* to meta zones mapping data are stored by date range.
|
||
|
|
*
|
||
|
|
* <p><b>Note:</b>
|
||
|
|
* <p>
|
||
|
|
* {@link TimeZoneFormat} assumes an instance of <code>TimeZoneNames</code> is immutable. If you want to provide
|
||
|
|
* your own <code>TimeZoneNames</code> implementation and use it with {@link TimeZoneFormat}, you must follow
|
||
|
|
* the contract.
|
||
|
|
* <p>
|
||
|
|
* The methods in this class assume that time zone IDs are already canonicalized. For example, you may not get proper
|
||
|
|
* result returned by a method with time zone ID "America/Indiana/Indianapolis", because it's not a canonical time zone
|
||
|
|
* ID (the canonical time zone ID for the time zone is "America/Indianapolis". See
|
||
|
|
* {@link TimeZone#getCanonicalID(String)} about ICU canonical time zone IDs.
|
||
|
|
*
|
||
|
|
* <p>
|
||
|
|
* In CLDR, most of time zone display names except location names are provided through meta zones. But a time zone may
|
||
|
|
* have a specific name that is not shared with other time zones.
|
||
|
|
*
|
||
|
|
* For example, time zone "Europe/London" has English long name for standard time "Greenwich Mean Time", which is also
|
||
|
|
* shared with other time zones. However, the long name for daylight saving time is "British Summer Time", which is only
|
||
|
|
* used for "Europe/London".
|
||
|
|
*
|
||
|
|
* <p>
|
||
|
|
* {@link #getTimeZoneDisplayName(String, NameType)} is designed for accessing a name only used by a single time zone.
|
||
|
|
* But is not necessarily mean that a subclass implementation use the same model with CLDR. A subclass implementation
|
||
|
|
* may provide time zone names only through {@link #getTimeZoneDisplayName(String, NameType)}, or only through
|
||
|
|
* {@link #getMetaZoneDisplayName(String, NameType)}, or both.
|
||
|
|
*
|
||
|
|
* <p>
|
||
|
|
* The default <code>TimeZoneNames</code> implementation returned by {@link #getInstance(ULocale)} uses the locale data
|
||
|
|
* imported from CLDR. In CLDR, set of meta zone IDs and mappings between zone IDs and meta zone IDs are shared by all
|
||
|
|
* locales. Therefore, the behavior of {@link #getAvailableMetaZoneIDs()}, {@link #getAvailableMetaZoneIDs(String)},
|
||
|
|
* {@link #getMetaZoneID(String, long)}, and {@link #getReferenceZoneID(String, String)} won't be changed no matter
|
||
|
|
* what locale is used for getting an instance of <code>TimeZoneNames</code>.
|
||
|
|
*/
|
||
|
|
public abstract class TimeZoneNames implements Serializable {
|
||
|
|
|
||
|
|
private static final long serialVersionUID = -9180227029248969153L;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Time zone display name types
|
||
|
|
*/
|
||
|
|
public enum NameType {
|
||
|
|
/**
|
||
|
|
* Long display name, such as "Eastern Time".
|
||
|
|
*/
|
||
|
|
LONG_GENERIC,
|
||
|
|
/**
|
||
|
|
* Long display name for standard time, such as "Eastern Standard Time".
|
||
|
|
*/
|
||
|
|
LONG_STANDARD,
|
||
|
|
/**
|
||
|
|
* Long display name for daylight saving time, such as "Eastern Daylight Time".
|
||
|
|
*/
|
||
|
|
LONG_DAYLIGHT,
|
||
|
|
/**
|
||
|
|
* Short display name, such as "ET".
|
||
|
|
*/
|
||
|
|
SHORT_GENERIC,
|
||
|
|
/**
|
||
|
|
* Short display name for standard time, such as "EST".
|
||
|
|
*/
|
||
|
|
SHORT_STANDARD,
|
||
|
|
/**
|
||
|
|
* Short display name for daylight saving time, such as "EDT".
|
||
|
|
*/
|
||
|
|
SHORT_DAYLIGHT,
|
||
|
|
/**
|
||
|
|
* Exemplar location name, such as "Los Angeles".
|
||
|
|
*/
|
||
|
|
EXEMPLAR_LOCATION,
|
||
|
|
}
|
||
|
|
|
||
|
|
private static Cache TZNAMES_CACHE = new Cache();
|
||
|
|
|
||
|
|
private static final Factory TZNAMES_FACTORY;
|
||
|
|
private static final String FACTORY_NAME_PROP = "android.icu.text.TimeZoneNames.Factory.impl";
|
||
|
|
private static final String DEFAULT_FACTORY_CLASS = "android.icu.impl.TimeZoneNamesFactoryImpl";
|
||
|
|
|
||
|
|
static {
|
||
|
|
Factory factory = null;
|
||
|
|
String classname = ICUConfig.get(FACTORY_NAME_PROP, DEFAULT_FACTORY_CLASS);
|
||
|
|
while (true) {
|
||
|
|
try {
|
||
|
|
factory = (Factory) Class.forName(classname).newInstance();
|
||
|
|
break;
|
||
|
|
} catch (ClassNotFoundException cnfe) {
|
||
|
|
// fall through
|
||
|
|
} catch (IllegalAccessException iae) {
|
||
|
|
// fall through
|
||
|
|
} catch (InstantiationException ie) {
|
||
|
|
// fall through
|
||
|
|
}
|
||
|
|
if (classname.equals(DEFAULT_FACTORY_CLASS)) {
|
||
|
|
break;
|
||
|
|
}
|
||
|
|
classname = DEFAULT_FACTORY_CLASS;
|
||
|
|
}
|
||
|
|
|
||
|
|
if (factory == null) {
|
||
|
|
factory = new DefaultTimeZoneNames.FactoryImpl();
|
||
|
|
}
|
||
|
|
TZNAMES_FACTORY = factory;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns an instance of <code>TimeZoneNames</code> for the specified locale.
|
||
|
|
*
|
||
|
|
* @param locale
|
||
|
|
* The locale.
|
||
|
|
* @return An instance of <code>TimeZoneNames</code>
|
||
|
|
*/
|
||
|
|
public static TimeZoneNames getInstance(ULocale locale) {
|
||
|
|
String key = locale.getBaseName();
|
||
|
|
return TZNAMES_CACHE.getInstance(key, locale);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns an instance of <code>TimeZoneNames</code> for the specified
|
||
|
|
* {@link java.util.Locale}.
|
||
|
|
*
|
||
|
|
* @param locale
|
||
|
|
* The {@link java.util.Locale}.
|
||
|
|
* @return An instance of <code>TimeZoneDisplayNames</code>
|
||
|
|
*/
|
||
|
|
public static TimeZoneNames getInstance(Locale locale) {
|
||
|
|
return getInstance(ULocale.forLocale(locale));
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns an instance of <code>TimeZoneNames</code> containing only short specific
|
||
|
|
* zone names ({@link NameType#SHORT_STANDARD} and {@link NameType#SHORT_DAYLIGHT}),
|
||
|
|
* compatible with the IANA tz database's zone abbreviations (not localized).
|
||
|
|
* <br>
|
||
|
|
* Note: The input locale is used for resolving ambiguous names (e.g. "IST" is parsed
|
||
|
|
* as Israel Standard Time for Israel, while it is parsed as India Standard Time for
|
||
|
|
* all other regions). The zone names returned by this instance are not localized.
|
||
|
|
*/
|
||
|
|
public static TimeZoneNames getTZDBInstance(ULocale locale) {
|
||
|
|
return new TZDBTimeZoneNames(locale);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns an immutable set of all available meta zone IDs.
|
||
|
|
* @return An immutable set of all available meta zone IDs.
|
||
|
|
*/
|
||
|
|
public abstract Set<String> getAvailableMetaZoneIDs();
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns an immutable set of all available meta zone IDs used by the given time zone.
|
||
|
|
*
|
||
|
|
* @param tzID
|
||
|
|
* The canonical time zone ID.
|
||
|
|
* @return An immutable set of all available meta zone IDs used by the given time zone.
|
||
|
|
*/
|
||
|
|
public abstract Set<String> getAvailableMetaZoneIDs(String tzID);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the meta zone ID for the given canonical time zone ID at the given date.
|
||
|
|
*
|
||
|
|
* @param tzID
|
||
|
|
* The canonical time zone ID.
|
||
|
|
* @param date
|
||
|
|
* The date.
|
||
|
|
* @return The meta zone ID for the given time zone ID at the given date. If the time zone does not have a
|
||
|
|
* corresponding meta zone at the given date or the implementation does not support meta zones, null is
|
||
|
|
* returned.
|
||
|
|
*/
|
||
|
|
public abstract String getMetaZoneID(String tzID, long date);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the reference zone ID for the given meta zone ID for the region.
|
||
|
|
*
|
||
|
|
* Note: Each meta zone must have a reference zone associated with a special region "001" (world).
|
||
|
|
* Some meta zones may have region specific reference zone IDs other than the special region
|
||
|
|
* "001". When a meta zone does not have any region specific reference zone IDs, this method
|
||
|
|
* return the reference zone ID for the special region "001" (world).
|
||
|
|
*
|
||
|
|
* @param mzID
|
||
|
|
* The meta zone ID.
|
||
|
|
* @param region
|
||
|
|
* The region.
|
||
|
|
* @return The reference zone ID ("golden zone" in the LDML specification) for the given time zone ID for the
|
||
|
|
* region. If the meta zone is unknown or the implementation does not support meta zones, null is returned.
|
||
|
|
*/
|
||
|
|
public abstract String getReferenceZoneID(String mzID, String region);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the display name of the meta zone.
|
||
|
|
*
|
||
|
|
* @param mzID
|
||
|
|
* The meta zone ID.
|
||
|
|
* @param type
|
||
|
|
* The display name type. See {@link TimeZoneNames.NameType}.
|
||
|
|
* @return The display name of the meta zone. When this object does not have a localized display name for the given
|
||
|
|
* meta zone with the specified type or the implementation does not provide any display names associated
|
||
|
|
* with meta zones, null is returned.
|
||
|
|
*/
|
||
|
|
public abstract String getMetaZoneDisplayName(String mzID, NameType type);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the display name of the time zone at the given date.
|
||
|
|
*
|
||
|
|
* <p>
|
||
|
|
* <b>Note:</b> This method calls the subclass's {@link #getTimeZoneDisplayName(String, NameType)} first. When the
|
||
|
|
* result is null, this method calls {@link #getMetaZoneID(String, long)} to get the meta zone ID mapped from the
|
||
|
|
* time zone, then calls {@link #getMetaZoneDisplayName(String, NameType)}.
|
||
|
|
*
|
||
|
|
* @param tzID
|
||
|
|
* The canonical time zone ID.
|
||
|
|
* @param type
|
||
|
|
* The display name type. See {@link TimeZoneNames.NameType}.
|
||
|
|
* @param date
|
||
|
|
* The date
|
||
|
|
* @return The display name for the time zone at the given date. When this object does not have a localized display
|
||
|
|
* name for the time zone with the specified type and date, null is returned.
|
||
|
|
*/
|
||
|
|
public final String getDisplayName(String tzID, NameType type, long date) {
|
||
|
|
String name = getTimeZoneDisplayName(tzID, type);
|
||
|
|
if (name == null) {
|
||
|
|
String mzID = getMetaZoneID(tzID, date);
|
||
|
|
name = getMetaZoneDisplayName(mzID, type);
|
||
|
|
}
|
||
|
|
return name;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the display name of the time zone. Unlike {@link #getDisplayName(String, NameType, long)},
|
||
|
|
* this method does not get a name from a meta zone used by the time zone.
|
||
|
|
*
|
||
|
|
* @param tzID
|
||
|
|
* The canonical time zone ID.
|
||
|
|
* @param type
|
||
|
|
* The display name type. See {@link TimeZoneNames.NameType}.
|
||
|
|
* @return The display name for the time zone. When this object does not have a localized display name for the given
|
||
|
|
* time zone with the specified type, null is returned.
|
||
|
|
*/
|
||
|
|
public abstract String getTimeZoneDisplayName(String tzID, NameType type);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the exemplar location name for the given time zone. When this object does not have a localized location
|
||
|
|
* name, the default implementation may still returns a programmatically generated name with the logic described
|
||
|
|
* below.
|
||
|
|
* <ol>
|
||
|
|
* <li>Check if the ID contains "/". If not, return null.
|
||
|
|
* <li>Check if the ID does not start with "Etc/" or "SystemV/". If it does, return null.
|
||
|
|
* <li>Extract a substring after the last occurrence of "/".
|
||
|
|
* <li>Replace "_" with " ".
|
||
|
|
* </ol>
|
||
|
|
* For example, "New York" is returned for the time zone ID "America/New_York" when this object does not have the
|
||
|
|
* localized location name.
|
||
|
|
*
|
||
|
|
* @param tzID
|
||
|
|
* The canonical time zone ID
|
||
|
|
* @return The exemplar location name for the given time zone, or null when a localized location name is not
|
||
|
|
* available and the fallback logic described above cannot extract location from the ID.
|
||
|
|
*/
|
||
|
|
public String getExemplarLocationName(String tzID) {
|
||
|
|
return TimeZoneNamesImpl.getDefaultExemplarLocationName(tzID);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Finds time zone name prefix matches for the input text at the
|
||
|
|
* given offset and returns a collection of the matches.
|
||
|
|
*
|
||
|
|
* @param text the text.
|
||
|
|
* @param start the starting offset within the text.
|
||
|
|
* @param types the set of name types, or <code>null</code> for all name types.
|
||
|
|
* @return A collection of matches.
|
||
|
|
* @see NameType
|
||
|
|
* @see MatchInfo
|
||
|
|
* @hide draft / provisional / internal are hidden on Android
|
||
|
|
*/
|
||
|
|
public Collection<MatchInfo> find(CharSequence text, int start, EnumSet<NameType> types) {
|
||
|
|
throw new UnsupportedOperationException("The method is not implemented in TimeZoneNames base class.");
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* A <code>MatchInfo</code> represents a time zone name match used by
|
||
|
|
* {@link TimeZoneNames#find(CharSequence, int, EnumSet)}.
|
||
|
|
* @hide Only a subset of ICU is exposed in Android
|
||
|
|
* @hide draft / provisional / internal are hidden on Android
|
||
|
|
*/
|
||
|
|
public static class MatchInfo {
|
||
|
|
private NameType _nameType;
|
||
|
|
private String _tzID;
|
||
|
|
private String _mzID;
|
||
|
|
private int _matchLength;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Constructing a <code>MatchInfo</code>.
|
||
|
|
*
|
||
|
|
* @param nameType the name type enum.
|
||
|
|
* @param tzID the time zone ID, or null
|
||
|
|
* @param mzID the meta zone ID, or null
|
||
|
|
* @param matchLength the match length.
|
||
|
|
* @throws IllegalArgumentException when 1) <code>nameType</code> is <code>null</code>,
|
||
|
|
* or 2) both <code>tzID</code> and <code>mzID</code> are <code>null</code>,
|
||
|
|
* or 3) <code>matchLength</code> is 0 or smaller.
|
||
|
|
* @see NameType
|
||
|
|
* @hide draft / provisional / internal are hidden on Android
|
||
|
|
*/
|
||
|
|
public MatchInfo(NameType nameType, String tzID, String mzID, int matchLength) {
|
||
|
|
if (nameType == null) {
|
||
|
|
throw new IllegalArgumentException("nameType is null");
|
||
|
|
}
|
||
|
|
if (tzID == null && mzID == null) {
|
||
|
|
throw new IllegalArgumentException("Either tzID or mzID must be available");
|
||
|
|
}
|
||
|
|
if (matchLength <= 0) {
|
||
|
|
throw new IllegalArgumentException("matchLength must be positive value");
|
||
|
|
}
|
||
|
|
_nameType = nameType;
|
||
|
|
_tzID = tzID;
|
||
|
|
_mzID = mzID;
|
||
|
|
_matchLength = matchLength;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the time zone ID, or <code>null</code> if not available.
|
||
|
|
*
|
||
|
|
* <p><b>Note</b>: A <code>MatchInfo</code> must have either a time zone ID
|
||
|
|
* or a meta zone ID.
|
||
|
|
*
|
||
|
|
* @return the time zone ID, or <code>null</code>.
|
||
|
|
* @see #mzID()
|
||
|
|
* @hide draft / provisional / internal are hidden on Android
|
||
|
|
*/
|
||
|
|
public String tzID() {
|
||
|
|
return _tzID;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the meta zone ID, or <code>null</code> if not available.
|
||
|
|
*
|
||
|
|
* <p><b>Note</b>: A <code>MatchInfo</code> must have either a time zone ID
|
||
|
|
* or a meta zone ID.
|
||
|
|
*
|
||
|
|
* @return the meta zone ID, or <code>null</code>.
|
||
|
|
* @see #tzID()
|
||
|
|
* @hide draft / provisional / internal are hidden on Android
|
||
|
|
*/
|
||
|
|
public String mzID() {
|
||
|
|
return _mzID;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the time zone name type.
|
||
|
|
* @return the time zone name type enum.
|
||
|
|
* @see NameType
|
||
|
|
* @hide draft / provisional / internal are hidden on Android
|
||
|
|
*/
|
||
|
|
public NameType nameType() {
|
||
|
|
return _nameType;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the match length.
|
||
|
|
* @return the match length.
|
||
|
|
* @hide draft / provisional / internal are hidden on Android
|
||
|
|
*/
|
||
|
|
public int matchLength() {
|
||
|
|
return _matchLength;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @deprecated This API is ICU internal only.
|
||
|
|
* @hide original deprecated declaration
|
||
|
|
* @hide draft / provisional / internal are hidden on Android
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public void loadAllDisplayNames() {}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @deprecated This API is ICU internal only.
|
||
|
|
* @hide original deprecated declaration
|
||
|
|
* @hide draft / provisional / internal are hidden on Android
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public void getDisplayNames(String tzID, NameType[] types, long date,
|
||
|
|
String[] dest, int destOffset) {
|
||
|
|
if (tzID == null || tzID.length() == 0) {
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
String mzID = null;
|
||
|
|
for (int i = 0; i < types.length; ++i) {
|
||
|
|
NameType type = types[i];
|
||
|
|
String name = getTimeZoneDisplayName(tzID, type);
|
||
|
|
if (name == null) {
|
||
|
|
if (mzID == null) {
|
||
|
|
mzID = getMetaZoneID(tzID, date);
|
||
|
|
}
|
||
|
|
name = getMetaZoneDisplayName(mzID, type);
|
||
|
|
}
|
||
|
|
dest[destOffset + i] = name;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Sole constructor for invocation by subclass constructors.
|
||
|
|
*
|
||
|
|
* @hide draft / provisional / internal are hidden on Android
|
||
|
|
*/
|
||
|
|
protected TimeZoneNames() {
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* The super class of <code>TimeZoneNames</code> service factory classes.
|
||
|
|
*
|
||
|
|
* @deprecated This API is ICU internal only.
|
||
|
|
* @hide Only a subset of ICU is exposed in Android
|
||
|
|
* @hide original deprecated declaration
|
||
|
|
* @hide draft / provisional / internal are hidden on Android
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public static abstract class Factory {
|
||
|
|
/**
|
||
|
|
* The factory method of <code>TimeZoneNames</code>.
|
||
|
|
*
|
||
|
|
* @param locale
|
||
|
|
* The display locale
|
||
|
|
* @return An instance of <code>TimeZoneNames</code>.
|
||
|
|
* @deprecated This API is ICU internal only.
|
||
|
|
* @hide original deprecated declaration
|
||
|
|
* @hide draft / provisional / internal are hidden on Android
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public abstract TimeZoneNames getTimeZoneNames(ULocale locale);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Sole constructor
|
||
|
|
* @deprecated This API is ICU internal only.
|
||
|
|
* @hide original deprecated declaration
|
||
|
|
* @hide draft / provisional / internal are hidden on Android
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
protected Factory() {
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* TimeZoneNames cache used by {@link TimeZoneNames#getInstance(ULocale)}
|
||
|
|
*/
|
||
|
|
private static class Cache extends SoftCache<String, TimeZoneNames, ULocale> {
|
||
|
|
|
||
|
|
/*
|
||
|
|
* (non-Javadoc)
|
||
|
|
*
|
||
|
|
* @see android.icu.impl.CacheBase#createInstance(java.lang.Object, java.lang.Object)
|
||
|
|
*/
|
||
|
|
@Override
|
||
|
|
protected TimeZoneNames createInstance(String key, ULocale data) {
|
||
|
|
return TZNAMES_FACTORY.getTimeZoneNames(data);
|
||
|
|
}
|
||
|
|
|
||
|
|
}
|
||
|
|
|
||
|
|
///CLOVER:OFF
|
||
|
|
/**
|
||
|
|
* The default implementation of <code>TimeZoneNames</code> used by {@link TimeZoneNames#getInstance(ULocale)} when
|
||
|
|
* the ICU4J tznamedata component is not available.
|
||
|
|
*/
|
||
|
|
private static class DefaultTimeZoneNames extends TimeZoneNames {
|
||
|
|
|
||
|
|
private static final long serialVersionUID = -995672072494349071L;
|
||
|
|
|
||
|
|
public static final DefaultTimeZoneNames INSTANCE = new DefaultTimeZoneNames();
|
||
|
|
|
||
|
|
/* (non-Javadoc)
|
||
|
|
* @see android.icu.text.TimeZoneNames#getAvailableMetaZoneIDs()
|
||
|
|
*/
|
||
|
|
@Override
|
||
|
|
public Set<String> getAvailableMetaZoneIDs() {
|
||
|
|
return Collections.emptySet();
|
||
|
|
}
|
||
|
|
|
||
|
|
/* (non-Javadoc)
|
||
|
|
* @see android.icu.text.TimeZoneNames#getAvailableMetaZoneIDs(java.lang.String)
|
||
|
|
*/
|
||
|
|
@Override
|
||
|
|
public Set<String> getAvailableMetaZoneIDs(String tzID) {
|
||
|
|
return Collections.emptySet();
|
||
|
|
}
|
||
|
|
|
||
|
|
/*
|
||
|
|
* (non-Javadoc)
|
||
|
|
*
|
||
|
|
* @see android.icu.text.TimeZoneNames#getMetaZoneID (java.lang.String, long)
|
||
|
|
*/
|
||
|
|
@Override
|
||
|
|
public String getMetaZoneID(String tzID, long date) {
|
||
|
|
return null;
|
||
|
|
}
|
||
|
|
|
||
|
|
/*
|
||
|
|
* (non-Javadoc)
|
||
|
|
*
|
||
|
|
* @see android.icu.text.TimeZoneNames#getReferenceZoneID(java.lang.String, java.lang.String)
|
||
|
|
*/
|
||
|
|
@Override
|
||
|
|
public String getReferenceZoneID(String mzID, String region) {
|
||
|
|
return null;
|
||
|
|
}
|
||
|
|
|
||
|
|
/*
|
||
|
|
* (non-Javadoc)
|
||
|
|
* @see android.icu.text.TimeZoneNames#getMetaZoneDisplayName(java.lang.String, android.icu.text.TimeZoneNames.NameType)
|
||
|
|
*/
|
||
|
|
@Override
|
||
|
|
public String getMetaZoneDisplayName(String mzID, NameType type) {
|
||
|
|
return null;
|
||
|
|
}
|
||
|
|
|
||
|
|
/*
|
||
|
|
* (non-Javadoc)
|
||
|
|
* @see android.icu.text.TimeZoneNames#getTimeZoneDisplayName(java.lang.String, android.icu.text.TimeZoneNames.NameType)
|
||
|
|
*/
|
||
|
|
@Override
|
||
|
|
public String getTimeZoneDisplayName(String tzID, NameType type) {
|
||
|
|
return null;
|
||
|
|
}
|
||
|
|
|
||
|
|
/* (non-Javadoc)
|
||
|
|
* @see android.icu.text.TimeZoneNames#find(java.lang.CharSequence, int, android.icu.text.TimeZoneNames.NameType[])
|
||
|
|
*/
|
||
|
|
@Override
|
||
|
|
public Collection<MatchInfo> find(CharSequence text, int start, EnumSet<NameType> nameTypes) {
|
||
|
|
return Collections.emptyList();
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* The default <code>TimeZoneNames</code> factory called from {@link TimeZoneNames#getInstance(ULocale)} when
|
||
|
|
* the ICU4J tznamedata component is not available.
|
||
|
|
* @hide Only a subset of ICU is exposed in Android
|
||
|
|
*/
|
||
|
|
public static class FactoryImpl extends Factory {
|
||
|
|
|
||
|
|
@android.compat.annotation.UnsupportedAppUsage(maxTargetSdk = 30, trackingBug = 170729553)
|
||
|
|
public FactoryImpl() {
|
||
|
|
}
|
||
|
|
|
||
|
|
/*
|
||
|
|
* (non-Javadoc)
|
||
|
|
*
|
||
|
|
* @see android.icu.text.TimeZoneNames.Factory#getTimeZoneNames (android.icu.util.ULocale)
|
||
|
|
*/
|
||
|
|
@Override
|
||
|
|
public TimeZoneNames getTimeZoneNames(ULocale locale) {
|
||
|
|
return DefaultTimeZoneNames.INSTANCE;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
///CLOVER:ON
|
||
|
|
}
|