diff --git a/icu4j/main/classes/core/src/com/ibm/icu/text/TimeZoneNames.java b/icu4j/main/classes/core/src/com/ibm/icu/text/TimeZoneNames.java index febe69a8c7..bc6a398f34 100644 --- a/icu4j/main/classes/core/src/com/ibm/icu/text/TimeZoneNames.java +++ b/icu4j/main/classes/core/src/com/ibm/icu/text/TimeZoneNames.java @@ -63,6 +63,13 @@ import com.ibm.icu.util.ULocale; * may provide time zone names only through {@link #getTimeZoneDisplayName(String, NameType)}, or only through * {@link #getMetaZoneDisplayName(String, NameType)}, or both. * + *

+ * The default TimeZoneNames 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 TimeZoneNames. + * * @draft ICU 49 * @provisional This API might change or be removed in a future release. */ @@ -211,6 +218,11 @@ public abstract class TimeZoneNames implements Serializable { /** * 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