]> granicus.if.org Git - icu/commitdiff
ICU-9338 Promoting TimeZoneNames/TimeZoneFormat APIs from tech preview to draft.
authorYoshito Umaoka <y.umaoka@gmail.com>
Tue, 25 Sep 2012 22:45:40 +0000 (22:45 +0000)
committerYoshito Umaoka <y.umaoka@gmail.com>
Tue, 25 Sep 2012 22:45:40 +0000 (22:45 +0000)
X-SVN-Rev: 32427

icu4c/source/i18n/tzfmt.cpp
icu4c/source/i18n/unicode/tzfmt.h
icu4c/source/i18n/unicode/tznames.h

index 131d30b7ba0ba33708a5407baf6bf8124b22f36a..a86174559249bc73f65c74e46e5be8bc2c708944 100644 (file)
@@ -452,11 +452,11 @@ TimeZoneFormat::setTimeZoneNames(const TimeZoneNames &tznames) {
 }
 
 void
-TimeZoneFormat::setDefaultParseOptions(int32_t flags) {
+TimeZoneFormat::setDefaultParseOptions(uint32_t flags) {
     fDefParseOptionFlags = flags;
 }
 
-int32_t
+uint32_t
 TimeZoneFormat::getDefaultParseOptions(void) const {
     return fDefParseOptionFlags;
 }
index e8fe31e528cd239866f6eabcfdce0d3161caecfa..090d8d70ae4bad0cb7400640f506c03ebde80e31 100644 (file)
@@ -25,74 +25,74 @@ U_CDECL_BEGIN
 /**
  * Constants for time zone display format style used by format/parse APIs
  * in TimeZoneFormat.
- * @internal ICU 49 technology preview
+ * @draft ICU 50
  */
 typedef enum UTimeZoneFormatStyle {
     /**
      * Generic location format, such as "United States Time (New York)", "Italy Time"
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZFMT_STYLE_GENERIC_LOCATION,
     /**
      * Generic long non-location format, such as "Eastern Time".
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZFMT_STYLE_GENERIC_LONG,
     /**
      * Generic short non-location format, such as "ET".
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZFMT_STYLE_GENERIC_SHORT,
     /**
      * Specific long format, such as "Eastern Standard Time".
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZFMT_STYLE_SPECIFIC_LONG,
     /**
      * Specific short format, such as "EST", "PDT".
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZFMT_STYLE_SPECIFIC_SHORT,
     /**
      * RFC822 format, such as "-0500"
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZFMT_STYLE_RFC822,
     /**
      * Localized GMT offset format, such as "GMT-05:00", "UTC+0100"
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZFMT_STYLE_LOCALIZED_GMT,
     /**
      * ISO 8601 format (extended), such as "-05:00", "Z"(UTC)
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZFMT_STYLE_ISO8601
 } UTimeZoneFormatStyle;
 
 /**
  * Constants for GMT offset pattern types.
- * @internal ICU 49 technology preview
+ * @draft ICU 50
  */
 typedef enum UTimeZoneFormatGMTOffsetPatternType {
     /**
      * Positive offset with hour and minute fields
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZFMT_PAT_POSITIVE_HM,
     /**
      * Positive offset with hour, minute and second fields
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZFMT_PAT_POSITIVE_HMS,
     /**
      * Negative offset with hour and minute fields
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZFMT_PAT_NEGATIVE_HM,
     /**
      * Negative offset with hour, minute and second fields
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZFMT_PAT_NEGATIVE_HMS
 } UTimeZoneFormatGMTOffsetPatternType;
@@ -100,41 +100,41 @@ typedef enum UTimeZoneFormatGMTOffsetPatternType {
 /**
  * Constants for time types used by TimeZoneFormat APIs for
  * receiving time type (standard time, daylight time or unknown).
- * @internal ICU 49 technology preview
+ * @draft ICU 50
  */
 typedef enum UTimeZoneFormatTimeType {
     /**
      * Unknown
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZFMT_TIME_TYPE_UNKNOWN,
     /**
      * Standard time
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZFMT_TIME_TYPE_STANDARD,
     /**
      * Daylight saving time
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZFMT_TIME_TYPE_DAYLIGHT
 } UTimeZoneFormatTimeType;
 
 /**
  * Constants for parse option flags, used for specifying optional parse behavior.
- * @internal ICU 49 technology preview
+ * @draft ICU 50
  */
 typedef enum UTimeZoneFormatParseOption {
     /**
      * No option.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZFMT_PARSE_OPTION_NONE        = 0x00,
     /**
      * When a time zone display name is not found within a set of display names
      * used for the specified style, look for the name from display names used
      * by other styles.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZFMT_PARSE_OPTION_ALL_STYLES  = 0x01
 } UTimeZoneFormatParseOption;
@@ -161,25 +161,25 @@ class UVector;
  * 
  * @see SimpleDateFormat
  * @see TimeZoneNames
- * @internal ICU 49 technology preview
+ * @draft ICU 50
  */
 class U_I18N_API TimeZoneFormat : public Format {
 public:
     /**
      * Copy constructor.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     TimeZoneFormat(const TimeZoneFormat& other);
 
     /**
      * Destructor.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual ~TimeZoneFormat();
 
     /**
      * Assignment operator.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     TimeZoneFormat& operator=(const TimeZoneFormat& other);
 
@@ -189,7 +189,7 @@ public:
      * @param other The object to be compared with.
      * @return Return TRUE if the given Format objects are semantically equal.
      *                Objects of different subclasses are considered unequal.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual UBool operator==(const Format& other) const;
 
@@ -197,7 +197,7 @@ public:
      * Clone this object polymorphically. The caller is responsible
      * for deleting the result when done.
      * @return A copy of the object
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual Format* clone() const;
 
@@ -207,14 +207,14 @@ public:
      * @param status Recevies the status.
      * @return An instance of <code>TimeZoneFormat</code> for the given locale,
      *          owned by the caller.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     static TimeZoneFormat* U_EXPORT2 createInstance(const Locale& locale, UErrorCode& status);
 
     /**
      * Returns the time zone display name data used by this instance.
      * @return The time zone display name data.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     const TimeZoneNames* getTimeZoneNames() const;
 
@@ -223,14 +223,14 @@ public:
      * The caller should not delete the TimeZoenNames object after it is adopted
      * by this call.
      * @param tznames TimeZoneNames object to be adopted.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     void adoptTimeZoneNames(TimeZoneNames *tznames);
 
     /**
      * Sets the time zone display name data to this format instnace.
      * @param tznames TimeZoneNames object to be set.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     void setTimeZoneNames(const TimeZoneNames &tznames);
 
@@ -239,7 +239,7 @@ public:
      * @param pattern Receives the localized GMT format pattern.
      * @return A reference to the result pattern.
      * @see #setGMTPattern
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UnicodeString& getGMTPattern(UnicodeString& pattern) const;
 
@@ -249,7 +249,7 @@ public:
      * @param pattern The localized GMT format pattern to be used by this object.
      * @param status Recieves the status.
      * @see #getGMTPattern
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     void setGMTPattern(const UnicodeString& pattern, UErrorCode& status);
 
@@ -259,7 +259,7 @@ public:
      * @param pattern Receives the offset pattern.
      * @return A reference to the result pattern.
      * @see #setGMTOffsetPattern
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UnicodeString& getGMTOffsetPattern(UTimeZoneFormatGMTOffsetPatternType type, UnicodeString& pattern) const;
 
@@ -269,23 +269,32 @@ public:
      * @param pattern The offset pattern used for localized GMT format for the type.
      * @param status Receives the status.
      * @see #getGMTOffsetPattern
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     void setGMTOffsetPattern(UTimeZoneFormatGMTOffsetPatternType type, const UnicodeString& pattern, UErrorCode& status);
 
     /**
-     * Returns the decimal digit characters used for localized GMT format in a single string
-     * containing from 0 to 9 in the ascending order.
+     * Returns the decimal digit characters used for localized GMT format.
+     * The return string contains exactly 10 code points (may include Unicode
+     * supplementary character) representing digit 0 to digit 9 in the ascending
+     * order.
      * @param digits Receives the decimal digits used for localized GMT format.
      * @see #setGMTOffsetDigits
+     * @draft ICU 50
      */
     UnicodeString& getGMTOffsetDigits(UnicodeString& digits) const;
 
     /**
      * Sets the decimal digit characters used for localized GMT format.
+     * The input <code>digits</code> must contain exactly 10 code points
+     * (Unicode supplementary characters are also allowed) representing
+     * digit 0 to digit 9 in the ascending order. When the input <code>digits</code>
+     * does not satisfy the condition, <code>U_ILLEGAL_ARGUMENT_ERROR</code>
+     * will be set to the return status.
      * @param digits The decimal digits used for localized GMT format.
      * @param status Receives the status.
      * @see #getGMTOffsetDigits
+     * @draft ICU 50
      */
     void setGMTOffsetDigits(const UnicodeString& digits, UErrorCode& status);
 
@@ -294,6 +303,7 @@ public:
      * @param gmtZeroFormat Receives the localized GMT string string for GMT(UTC) itself.
      * @return A reference to the result GMT string.
      * @see #setGMTZeroFormat
+     * @draft ICU 50
      */
     UnicodeString& getGMTZeroFormat(UnicodeString& gmtZeroFormat) const;
 
@@ -302,6 +312,7 @@ public:
      * @param gmtZeroFormat The localized GMT format string for GMT(UTC).
      * @param status Receives the status.
      * @see #getGMTZeroFormat
+     * @draft ICU 50
      */
     void setGMTZeroFormat(const UnicodeString& gmtZeroFormat, UErrorCode& status);
 
@@ -310,9 +321,9 @@ public:
      * options used by this object.
      * @return the default parse options.
      * @see ParseOption
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
-    int32_t getDefaultParseOptions(void) const;
+    uint32_t getDefaultParseOptions(void) const;
 
     /**
      * Sets the default parse options.
@@ -320,9 +331,9 @@ public:
      * created by {@link #createInstance} has no parse options set (UTZFMT_PARSE_OPTION_NONE).
      * To specify multipe options, use bitwise flags of UTimeZoneFormatParseOption.
      * @see #UTimeZoneFormatParseOption
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
-    void setDefaultParseOptions(int32_t flags);
+    void setDefaultParseOptions(uint32_t flags);
 
     /**
      * Returns the RFC822 style time zone string for the given offset.
@@ -332,7 +343,7 @@ public:
      * @return A reference to the result.
      * @param status Receives the status
      * @see #parseOffsetRFC822
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UnicodeString& formatOffsetRFC822(int32_t offset, UnicodeString& result, UErrorCode& status) const;
 
@@ -344,7 +355,7 @@ public:
      * @param status Receives the status
      * @return A reference to the result.
      * @see #parseOffsetISO8601
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UnicodeString& formatOffsetISO8601(int32_t offset, UnicodeString& result, UErrorCode& status) const;
 
@@ -362,7 +373,7 @@ public:
      * @param result Receives the localized GMT format string.
      * @return A reference to the result.
      * @see #parseOffsetLocalizedGMT
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UnicodeString& formatOffsetLocalizedGMT(int32_t offset, UnicodeString& result, UErrorCode& status) const;
 
@@ -377,7 +388,7 @@ public:
      * @return A reference to the result
      * @see #UTimeZoneFormatStyle
      * @see #UTimeZoneFormatTimeType
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual UnicodeString& format(UTimeZoneFormatStyle style, const TimeZone& tz, UDate date,
         UnicodeString& name, UTimeZoneFormatTimeType* timeType = NULL) const;
@@ -393,7 +404,7 @@ public:
      * @return The offset from GMT(UTC) in milliseconds for the given RFC822 style
      *              time zone string.
      * @see #formatOffsetRFC822
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     int32_t parseOffsetRFC822(const UnicodeString& text, ParsePosition& pos) const;
 
@@ -402,13 +413,13 @@ public:
      * style time zone string. When the given string is not an ISO 8601 time zone
      * string, this method sets the current position as the error index
      * to <code>ParsePosition pos</code> and returns 0.
-     * @param text The text contains RFC822 style time zone string (e.g. "-08:00", "Z")
+     * @param text The text contains ISO8601 style time zone string (e.g. "-08:00", "Z")
      *              at the position.
      * @param pos The ParsePosition object.
      * @return The offset from GMT(UTC) in milliseconds for the given ISO 8601 style
      *              time zone string.
      * @see #formatOffsetISO8601
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     int32_t parseOffsetISO8601(const UnicodeString& text, ParsePosition& pos) const;
 
@@ -422,7 +433,7 @@ public:
      * @return The offset from GMT(UTC) in milliseconds for the given localized GMT
      *          offset format string.
      * @see #formatOffsetLocalizedGMT
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     int32_t parseOffsetLocalizedGMT(const UnicodeString& text, ParsePosition& pos) const;
 
@@ -440,7 +451,7 @@ public:
      * @see UTimeZoneFormatStyle
      * @see UTimeZoneFormatParseOption
      * @see UTimeZoneFormatTimeType
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual TimeZone* parse(UTimeZoneFormatStyle style, const UnicodeString& text, ParsePosition& pos,
         int32_t parseOptions, UTimeZoneFormatTimeType* timeType = NULL) const;
@@ -458,7 +469,7 @@ public:
      * @see UTimeZoneFormatStyle
      * @see UTimeZoneFormatParseOption
      * @see UTimeZoneFormatTimeType
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     TimeZone* parse(UTimeZoneFormatStyle style, const UnicodeString& text, ParsePosition& pos,
         UTimeZoneFormatTimeType* timeType = NULL) const;
@@ -476,7 +487,7 @@ public:
      * @param pos On input: an alignment field, if desired. On output: the offsets of the alignment field.
      * @param status Output param filled with success/failure status.
      * @return Reference to 'appendTo' parameter.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual UnicodeString& format(const Formattable& obj, UnicodeString& appendTo,
         FieldPosition& pos, UErrorCode& status) const;
@@ -491,19 +502,19 @@ public:
      *                  will remain unchanged.
      * @return A newly created Formattable* object, or NULL on failure.  The caller owns this and should
      *                 delete it when done.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual void parseObject(const UnicodeString& source, Formattable& result, ParsePosition& parse_pos) const;
 
     /**
      * ICU "poor man's RTTI", returns a UClassID for this class.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     static UClassID U_EXPORT2 getStaticClassID(void);
 
     /**
      * ICU "poor man's RTTI", returns a UClassID for the actual class.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual UClassID getDynamicClassID() const;
 
@@ -512,7 +523,7 @@ protected:
      * Constructs a TimeZoneFormat object for the specified locale.
      * @param locale the locale
      * @param status receives the status.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     TimeZoneFormat(const Locale& locale, UErrorCode& status);
 
@@ -545,7 +556,7 @@ private:
     UnicodeString fGMTZeroFormat;
 
     /* Bit flags representing parse options */
-    int32_t fDefParseOptionFlags;
+    uint32_t fDefParseOptionFlags;
 
     /* Constant parts of GMT format pattern, populated from localized GMT format pattern*/
     UnicodeString fGMTPatternPrefix;    /* Substring before {0} */
index 4e39c47efe3bd4065daf4e72065d20a831259290..2de296d50ee27777556c03799b811c61deee1d51 100644 (file)
@@ -23,42 +23,42 @@ U_CDECL_BEGIN
 
 /**
  * Constants for time zone display name types.
- * @internal ICU 49 technology preview
+ * @draft ICU 50
  */
 typedef enum UTimeZoneNameType {
     /**
      * Unknown display name type.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZNM_UNKNOWN           = 0x00,
     /**
      * Long display name, such as "Eastern Time".
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZNM_LONG_GENERIC      = 0x01,
     /**
      * Long display name for standard time, such as "Eastern Standard Time".
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZNM_LONG_STANDARD     = 0x02,
     /**
      * Long display name for daylight saving time, such as "Eastern Daylight Time".
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZNM_LONG_DAYLIGHT     = 0x04,
     /**
      * Short display name, such as "ET".
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZNM_SHORT_GENERIC     = 0x08,
     /**
      * Short display name for standard time, such as "EST".
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZNM_SHORT_STANDARD    = 0x10,
     /**
      * Short display name for daylight saving time, such as "EDT".
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UTZNM_SHORT_DAYLIGHT    = 0x20
 } UTimeZoneNameType;
@@ -111,13 +111,13 @@ struct MatchInfo;
  * may provide time zone names only through {@link #getTimeZoneDisplayName}, or only through {@link #getMetaZoneDisplayName},
  * or both.
  * 
- * @internal ICU 49 technology preview
+ * @draft ICU 50
  */
 class U_I18N_API TimeZoneNames : public UObject {
 public:
     /**
      * Destructor.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual ~TimeZoneNames();
 
@@ -125,7 +125,7 @@ public:
      * Return true if the given TimeZoneNames objects are emantically equal.
      * @param other the object to be compared with.
      * @return Return TRUE if the given Format objects are semantically equal.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual UBool operator==(const TimeZoneNames& other) const = 0;
 
@@ -134,7 +134,7 @@ public:
      * equal.
      * @param other the object to be compared with.
      * @return Return TRUE if the given Format objects are not semantically equal.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     UBool operator!=(const TimeZoneNames& other) const { return !operator==(other); }
 
@@ -142,7 +142,7 @@ public:
      * Clone this object polymorphically.  The caller is responsible
      * for deleting the result when done.
      * @return A copy of the object
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual TimeZoneNames* clone() const = 0;
 
@@ -152,7 +152,7 @@ public:
      * @param locale The locale.
      * @param status Recevies the status.
      * @return An instance of <code>TimeZoneDisplayNames</code>
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     static TimeZoneNames* U_EXPORT2 createInstance(const Locale& locale, UErrorCode& status);
 
@@ -160,7 +160,7 @@ public:
      * Returns an enumeration of all available meta zone IDs.
      * @param status Recevies the status.
      * @return an enumeration object, owned by the caller.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual StringEnumeration* getAvailableMetaZoneIDs(UErrorCode& status) const = 0;
 
@@ -169,7 +169,7 @@ public:
      * @param tzID The canoical tiem zone ID.
      * @param status Recevies the status.
      * @return an enumeration object, owned by the caller.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual StringEnumeration* getAvailableMetaZoneIDs(const UnicodeString& tzID, UErrorCode& status) const = 0;
 
@@ -181,7 +181,7 @@ public:
      *          corresponding meta zone at the given date or the implementation does not support meta zones, "bogus" state
      *          is set.
      * @return A reference to the result.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual UnicodeString& getMetaZoneID(const UnicodeString& tzID, UDate date, UnicodeString& mzID) const = 0;
 
@@ -193,7 +193,7 @@ public:
      *          region. If the meta zone is unknown or the implementation does not support meta zones, "bogus" state
      *          is set.
      * @return A reference to the result.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual UnicodeString& getReferenceZoneID(const UnicodeString& mzID, const char* region, UnicodeString& tzID) const = 0;
 
@@ -205,7 +205,7 @@ public:
      *         meta zone with the specified type or the implementation does not provide any display names associated
      *         with meta zones, "bogus" state is set.
      * @return A reference to the result.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual UnicodeString& getMetaZoneDisplayName(const UnicodeString& mzID, UTimeZoneNameType type, UnicodeString& name) const = 0;
 
@@ -217,7 +217,7 @@ public:
      * @param name Receives 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, "bogus" state is set.
      * @return A reference to the result.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual UnicodeString& getTimeZoneDisplayName(const UnicodeString& tzID, UTimeZoneNameType type, UnicodeString& name) const = 0;
 
@@ -238,7 +238,7 @@ public:
      * @param name Receives the exemplar location name for the given time zone, or "bogus" state is set when a localized
      *          location name is not available and the fallback logic described above cannot extract location from the ID.
      * @return A reference to the result.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual UnicodeString& getExemplarLocationName(const UnicodeString& tzID, UnicodeString& name) const;
 
@@ -255,25 +255,25 @@ public:
      * @param name Receives 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, "bogus" state is set.
      * @return A reference to the result.
-     * @internal ICU 49 technology preview
+     * @draft ICU 50
      */
     virtual UnicodeString& getDisplayName(const UnicodeString& tzID, UTimeZoneNameType type, UDate date, UnicodeString& name) const;
 
     /**
      * <code>MatchInfoCollection</code> represents a collection of time zone name matches used by
      * {@link TimeZoneNames#find}.
-     * @internal ICU 49 technology preview
+     * @internal
      */
     class U_I18N_API MatchInfoCollection : public UMemory {
     public:
         /**
          * Constructor.
-         * @internal ICU 49 technology preview
+         * @internal
          */
         MatchInfoCollection();
         /**
          * Destructor.
-         * @internal ICU 49 technology preview
+         * @internal
          */
         virtual ~MatchInfoCollection();
 
@@ -283,7 +283,7 @@ public:
          * @param matchLength The match length.
          * @param tzID The time zone ID.
          * @param status Receives the status
-         * @internal ICU 49 technology preview
+         * @internal
          */
         void addZone(UTimeZoneNameType nameType, int32_t matchLength,
             const UnicodeString& tzID, UErrorCode& status);
@@ -294,7 +294,7 @@ public:
          * @param matchLength The match length.
          * @param mzID The metazone ID.
          * @param status Receives the status
-         * @internal ICU 49 technology preview
+         * @internal
          */
         void addMetaZone(UTimeZoneNameType nameType, int32_t matchLength,
             const UnicodeString& mzID, UErrorCode& status);
@@ -302,7 +302,7 @@ public:
         /**
          * Returns the number of entries available in this object.
          * @return The number of entries.
-         * @internal ICU 49 technology preview
+         * @internal
          */
         int32_t size() const;
 
@@ -312,7 +312,7 @@ public:
          * @return The time zone name type. If the specified idx is out of range,
          *      it returns UTZNM_UNKNOWN.
          * @see UTimeZoneNameType
-         * @internal ICU 49 technology preview
+         * @internal
          */
         UTimeZoneNameType getNameTypeAt(int32_t idx) const;
 
@@ -321,7 +321,7 @@ public:
          * @param idx The index
          * @return The match length. If the specified idx is out of range,
          *      it returns 0.
-         * @internal ICU 49 technology preview
+         * @internal
          */
         int32_t getMatchLengthAt(int32_t idx) const;
 
@@ -330,7 +330,7 @@ public:
          * @param idx The index
          * @param tzID Receives the zone ID.
          * @return TRUE if the zone ID was set to tzID.
-         * @internal ICU 49 technology preview
+         * @internal
          */
         UBool getTimeZoneIDAt(int32_t idx, UnicodeString& tzID) const;
 
@@ -339,7 +339,7 @@ public:
          * @param idx The index
          * @param mzID Receives the metazone ID
          * @return TRUE if the meta zone ID was set to mzID.
-         * @internal ICU 49 technology preview
+         * @internal
          */
         UBool getMetaZoneIDAt(int32_t idx, UnicodeString& mzID) const;
 
@@ -360,7 +360,7 @@ public:
      * @return A collection of matches (owned by the caller), or NULL if no matches are found.
      * @see UTimeZoneNameType
      * @see MatchInfoCollection
-     * @internal ICU 49 technology preview
+     * @internal
      */
     virtual MatchInfoCollection* find(const UnicodeString& text, int32_t start, uint32_t types, UErrorCode& status) const = 0;