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