ICU-22723 Frontload ICU4J API promotions (BRS unicode-org#18)

markusicu · Sep 18, 2024 · c92bf3d · c92bf3d
1 parent feca6ee
commit c92bf3d
Show file tree

Hide file tree

Showing 13 changed files with 28 additions and 28 deletions.
diff --git a/icu4j/main/core/src/main/java/com/ibm/icu/lang/UProperty.java b/icu4j/main/core/src/main/java/com/ibm/icu/lang/UProperty.java
@@ -621,23 +621,23 @@ public interface UProperty
      * Binary property IDS_Unary_Operator.
      * For programmatic determination of Ideographic Description Sequences.
      *
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public static final int IDS_UNARY_OPERATOR = 72;
 
     /**
      * Binary property ID_Compat_Math_Start.
      * <p>Used in mathematical identifier profile in UAX #31.
      *
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public static final int ID_COMPAT_MATH_START = 73;
 
     /**
      * Binary property ID_Compat_Math_Continue.
      * <p>Used in mathematical identifier profile in UAX #31.
      *
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public static final int ID_COMPAT_MATH_CONTINUE = 74;
 

diff --git a/icu4j/main/core/src/main/java/com/ibm/icu/number/LocalizedNumberFormatter.java b/icu4j/main/core/src/main/java/com/ibm/icu/number/LocalizedNumberFormatter.java
@@ -125,7 +125,7 @@ public Format toFormat() {
      * Disassociate the locale from this formatter.
      *
      * @return The fluent chain.
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public UnlocalizedNumberFormatter withoutLocale() {
         return new UnlocalizedNumberFormatter(this, KEY_LOCALE, null);

diff --git a/icu4j/main/core/src/main/java/com/ibm/icu/number/LocalizedNumberRangeFormatter.java b/icu4j/main/core/src/main/java/com/ibm/icu/number/LocalizedNumberRangeFormatter.java
@@ -86,7 +86,7 @@ public FormattedNumberRange formatRange(Number first, Number second) {
      * Disassociate the locale from this formatter.
      *
      * @return The fluent chain.
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public UnlocalizedNumberRangeFormatter withoutLocale() {
         return new UnlocalizedNumberRangeFormatter(this, KEY_LOCALE, null);

diff --git a/icu4j/main/core/src/main/java/com/ibm/icu/text/Normalizer2.java b/icu4j/main/core/src/main/java/com/ibm/icu/text/Normalizer2.java
@@ -178,7 +178,7 @@ public static Normalizer2 getNFKCCasefoldInstance() {
      * <p>Same as getInstance(null, "nfkc_scf", Mode.COMPOSE).
      * Returns an unmodifiable singleton instance.
      * @return the requested Normalizer2, if successful
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public static Normalizer2 getNFKCSimpleCasefoldInstance() {
         return Norm2AllModes.getNFKC_SCFInstance().comp;

diff --git a/icu4j/main/core/src/main/java/com/ibm/icu/text/PersonName.java b/icu4j/main/core/src/main/java/com/ibm/icu/text/PersonName.java
@@ -182,15 +182,15 @@ enum FieldModifier {
          * Requests the genitive form of the field's contents, if possible.  The default implementation
          * does nothing, but subclasses of PersonName can override getFieldValue() to produce the genitive
          * form (or just add an "xxx-genitive" entry to a SimplePersonName).
-         * @draft ICU 74
+         * @stable ICU 74
          */
         GENITIVE("genitive"),
 
         /**
          * Requests the vocative form of the field's contents, if possible.  The default implementation
          * does nothing, but subclasses of PersonName can override getFieldValue() to produce the vocative
          * form (or just add an "xxx-vocative" entry to a SimplePersonName).
-         * @draft ICU 74
+         * @stable ICU 74
          */
         VOCATIVE("vocative");
 

diff --git a/icu4j/main/core/src/main/java/com/ibm/icu/text/PersonNameFormatter.java b/icu4j/main/core/src/main/java/com/ibm/icu/text/PersonNameFormatter.java
@@ -96,7 +96,7 @@ public enum Length {
 
         /**
          * The default name length for the locale.  For most locales, this is the same as MEDIUM.
-         * @draft ICU 74
+         * @stable ICU 74
          */
         DEFAULT
     }
@@ -149,7 +149,7 @@ public enum Formality {
         /**
          * The default formality for the locale.  For most locales, this is the same as FORMAL, but for English,
          * this is the same as INFORMAL.
-         * @draft ICU 74
+         * @stable ICU 74
          */
         DEFAULT
     }
@@ -176,14 +176,14 @@ public enum DisplayOrder {
         /**
          * Forces the formatter to format the name in given-first order.  If the name itself specifies
          * a display order, this overrides it.
-         * @draft ICU 74
+         * @stable ICU 74
          */
         FORCE_GIVEN_FIRST,
 
         /**
          * Forces the formatter to format the name in surname-first order.  If the name itself specifies
          * a display order, this overrides it.
-         * @draft ICU 74
+         * @stable ICU 74
          */
         FORCE_SURNAME_FIRST,
     }

diff --git a/icu4j/main/core/src/main/java/com/ibm/icu/text/SpoofChecker.java b/icu4j/main/core/src/main/java/com/ibm/icu/text/SpoofChecker.java
@@ -1489,7 +1489,7 @@ public int areConfusable(String s1, String s2) {
      *            The second of the two strings to be compared for confusability.
      * @return Non-zero if s1 and s1 are confusable. If not 0, the value will indicate the type(s) of confusability
      *         found, as defined by spoof check test constants.
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public int areConfusable(int direction, CharSequence s1, CharSequence s2) {
         //
@@ -1554,7 +1554,7 @@ public int areConfusable(int direction, CharSequence s1, CharSequence s2) {
      * @param str The input string whose bidiSkeleton will be generated.
      * @return The output skeleton string.
      *
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public String getBidiSkeleton(int direction, CharSequence str) {
         if (direction != Bidi.DIRECTION_LEFT_TO_RIGHT && direction != Bidi.DIRECTION_RIGHT_TO_LEFT) {

diff --git a/icu4j/main/core/src/main/java/com/ibm/icu/util/CECalendar.java b/icu4j/main/core/src/main/java/com/ibm/icu/util/CECalendar.java
@@ -288,7 +288,7 @@ public static void jdToCE(int julianDay, int jdEpochOffset, int[] fields) {
      * month in each year in the CECalendar, the value is "M13".
      *
      * @return       One of 13 possible strings in {"M01".. "M12", "M13"}.
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public String getTemporalMonthCode() {
         if (get(MONTH) == 12) return "M13";
@@ -302,7 +302,7 @@ public String getTemporalMonthCode() {
      * (non-leap) year. For CECalendar calendar, the values are "M01" .. "M13"
      * while the "M13" is represent the short thirteen month in each year.
      * @param temporalMonth One of 13 possible strings in {"M01".. "M12", "M13"}.
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public void setTemporalMonthCode( String temporalMonth ) {
         if (temporalMonth.equals("M13")) {

diff --git a/icu4j/main/core/src/main/java/com/ibm/icu/util/Calendar.java b/icu4j/main/core/src/main/java/com/ibm/icu/util/Calendar.java
@@ -975,7 +975,7 @@ public abstract class Calendar implements Serializable, Cloneable, Comparable<Ca
      * is associated with ORDINAL_MONTH value 6 because 4665 is a leap year
      * and there is an extra "Leap Month 5" which associated with ORDINAL_MONTH
      * value 5 before "Month 6" of year 4664.
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public static final int ORDINAL_MONTH = 23;
 
@@ -2074,7 +2074,7 @@ public void setTimeInMillis( long millis ) {
      * proposal.
      * @return true if the date in the fields is in a Temporal proposal
      *               defined leap year. False otherwise.
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public boolean inTemporalLeapYear() {
         // Default to Gregorian based leap year rule.
@@ -2100,7 +2100,7 @@ public boolean inTemporalLeapYear() {
      * years are "M01" to "M13".
      *
      * @return       One of 25 possible strings in {"M01".."M13", "M01L".."M12L"}.
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public String getTemporalMonthCode() {
         int month = get(MONTH);
@@ -2124,7 +2124,7 @@ public String getTemporalMonthCode() {
      * years are "M01" to "M13".
      * @param temporalMonth One of 25 possible strings in {"M01".. "M12", "M13", "M01L",
      *  "M12L"}.
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public void setTemporalMonthCode( String temporalMonth ) {
         if (temporalMonth.length() == 3 && temporalMonth.charAt(0) == 'M') {

diff --git a/icu4j/main/core/src/main/java/com/ibm/icu/util/ChineseCalendar.java b/icu4j/main/core/src/main/java/com/ibm/icu/util/ChineseCalendar.java
@@ -1060,7 +1060,7 @@ private void readObject(ObjectInputStream stream)
      * proposal.
      * @return true if the date in the fields is in a Temporal proposal
      *               defined leap year. False otherwise.
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public boolean inTemporalLeapYear() {
         return getActualMaximum(DAY_OF_YEAR) > 360;
@@ -1080,7 +1080,7 @@ public boolean inTemporalLeapYear() {
      * non-leap year and * in leap year with another monthCode in "M01L" .. "M12L".
      *
      * @return       One of 24 possible strings in {"M01".."M12", "M01L".."M12L"}.
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public String getTemporalMonthCode() {
         // We need to call get, not internalGet, to force the calculation
@@ -1102,7 +1102,7 @@ public String getTemporalMonthCode() {
      * in leap year with another monthCode in "M01L" .. "M12L".
      * @param temporalMonth One of 25 possible strings in {"M01".. "M12", "M13", "M01L",
      *  "M12L"}.
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public void setTemporalMonthCode( String temporalMonth ) {
         if (temporalMonth.length() != 4 || temporalMonth.charAt(0) != 'M' || temporalMonth.charAt(3) != 'L') {

diff --git a/icu4j/main/core/src/main/java/com/ibm/icu/util/HebrewCalendar.java b/icu4j/main/core/src/main/java/com/ibm/icu/util/HebrewCalendar.java
@@ -919,7 +919,7 @@ public String getType() {
     //-------------------------------------------------------------------------
     /**
      * {@inheritDoc}
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public boolean inTemporalLeapYear() {
         return isLeapYear(get(EXTENDED_YEAR));
@@ -940,7 +940,7 @@ public boolean inTemporalLeapYear() {
      * non-leap year, and "M01" .. "M05", "M05L", "M06" .. "M12" for leap year.
      *
      * @return       One of 13 possible strings in {"M01".. "M05", "M05L", "M06" .. "M12"}.
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public String getTemporalMonthCode() {
         return gTemporalMonthCodesForHebrew[get(MONTH)];
@@ -955,7 +955,7 @@ public String getTemporalMonthCode() {
      * are "M01" .. "M12" for non-leap years, and "M01" .. "M05", "M05L", "M06"
      * .. "M12" for leap year.
      * @param temporalMonth The value to be set for temporal monthCode.
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public void setTemporalMonthCode( String temporalMonth ) {
         if (temporalMonth.length() == 3 || temporalMonth.length() == 4) {

diff --git a/icu4j/main/core/src/main/java/com/ibm/icu/util/IslamicCalendar.java b/icu4j/main/core/src/main/java/com/ibm/icu/util/IslamicCalendar.java
@@ -1189,7 +1189,7 @@ private void readObject(ObjectInputStream in) throws IOException,ClassNotFoundEx
      * proposal.
      * @return true if the date in the fields is in a Temporal proposal
      *               defined leap year. False otherwise.
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public boolean inTemporalLeapYear() {
         return getActualMaximum(DAY_OF_YEAR) == 355;

diff --git a/icu4j/main/core/src/main/java/com/ibm/icu/util/TimeZone.java b/icu4j/main/core/src/main/java/com/ibm/icu/util/TimeZone.java
@@ -1187,7 +1187,7 @@ public static String getCanonicalID(String id, boolean[] isSystemID) {
      * @return  The preferred time zone ID in the IANA time zone database, or {@link TimeZone#UNKNOWN_ZONE_ID}
      * if the input ID is not a system ID.
      * @see #getCanonicalID(String)
-     * @draft ICU 74
+     * @stable ICU 74
      */
     public static String getIanaID(String id) {
         String ianaId = TimeZone.UNKNOWN_ZONE_ID;