]> granicus.if.org Git - icu/commitdiff
ICU-13052 ICU4J 59 API promotion draft.
authorYoshito Umaoka <y.umaoka@gmail.com>
Mon, 20 Mar 2017 20:23:23 +0000 (20:23 +0000)
committerYoshito Umaoka <y.umaoka@gmail.com>
Mon, 20 Mar 2017 20:23:23 +0000 (20:23 +0000)
X-SVN-Rev: 39886

icu4j/APIChangeReport.html
icu4j/main/classes/core/src/com/ibm/icu/text/DateFormat.java
icu4j/main/classes/core/src/com/ibm/icu/text/RelativeDateTimeFormatter.java
icu4j/main/classes/core/src/com/ibm/icu/text/SimpleFormatter.java
icu4j/main/classes/core/src/com/ibm/icu/util/MeasureUnit.java

index 0ca6c07bd969b88f55e509db5724d8c21e9c6a7e..f6b724363e0065e8ce6fece4fa0607ea89c2bedd 100644 (file)
@@ -4,10 +4,10 @@
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
 <!-- © 2017 and later: Unicode, Inc. and others. -->
 <!-- License & terms of use: http://www.unicode.org/copyright.html#License -->
-<title>ICU4J API Comparison: ICU4J 58.1 with ICU4J 59.0.1</title>
+<title>ICU4J API Comparison: ICU4J 58.1 with ICU4J 59.1</title>
 </head>
 <body>
-<h1>ICU4J API Comparison: ICU4J 58.1 with ICU4J 59.0.1</h1>
+<h1>ICU4J API Comparison: ICU4J 58.1 with ICU4J 59.1</h1>
 
 <hr/>
 <h2>Removed from ICU4J 58.1</h2>
@@ -25,22 +25,130 @@ MeasureUnit
 
 
 <hr/>
-<h2>Deprecated or Obsoleted in ICU4J 59.0.1</h2>
-<p>(no API obsoleted)</p>
+<h2>Deprecated or Obsoleted in ICU4J 59.1</h2>
+
+<h3>Package com.ibm.icu.text</h3>
+<ul>
+DecimalFormat
+<ul>
+<li><span style='color:gray'>(deprecated)</span> public int <i>getParseMaxDigits</i>()</li>
+<li><span style='color:gray'>(deprecated)</span> public void <i>setParseMaxDigits</i>(int)</li>
+</ul>
+</ul>
+
 
 <hr/>
-<h2>Changed in ICU4J 59.0.1 (old, new)</h2>
+<h2>Changed in ICU4J 59.1 (old, new)</h2>
 <p>(no API changed)</p>
 
 <hr/>
-<h2>Promoted to stable in ICU4J 59.0.1</h2>
-<p>(no API promoted to stable)</p>
+<h2>Promoted to stable in ICU4J 59.1</h2>
+
+<h3>Package com.ibm.icu.text</h3>
+<ul>
+<li><span style='color:green'>(stable)</span> public final class <i>SimpleFormatter</i></li>
+RelativeDateTimeFormatter
+<ul>
+<li><span style='color:green'>(stable)</span> public java.lang.String <i>format</i>(double, RelativeDateTimeFormatter.RelativeDateTimeUnit)</li>
+<li><span style='color:green'>(stable)</span> public java.lang.String <i>formatNumeric</i>(double, RelativeDateTimeFormatter.RelativeDateTimeUnit)</li>
+</ul>
+RelativeDateTimeFormatter.RelativeDateTimeUnit
+<ul>
+<li><span style='color:green'>(stable)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit DAY</li>
+<li><span style='color:green'>(stable)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit FRIDAY</li>
+<li><span style='color:green'>(stable)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit HOUR</li>
+<li><span style='color:green'>(stable)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit MINUTE</li>
+<li><span style='color:green'>(stable)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit MONDAY</li>
+<li><span style='color:green'>(stable)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit MONTH</li>
+<li><span style='color:green'>(stable)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit QUARTER</li>
+<li><span style='color:green'>(stable)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit SATURDAY</li>
+<li><span style='color:green'>(stable)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit SECOND</li>
+<li><span style='color:green'>(stable)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit SUNDAY</li>
+<li><span style='color:green'>(stable)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit THURSDAY</li>
+<li><span style='color:green'>(stable)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit TUESDAY</li>
+<li><span style='color:green'>(stable)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit WEDNESDAY</li>
+<li><span style='color:green'>(stable)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit WEEK</li>
+<li><span style='color:green'>(stable)</span> public static final RelativeDateTimeFormatter.RelativeDateTimeUnit YEAR</li>
+</ul>
+</ul>
+
+<h3>Package com.ibm.icu.util</h3>
+<ul>
+MeasureUnit
+<ul>
+<li><span style='color:green'>(stable)</span> public static final MeasureUnit GALLON_IMPERIAL</li>
+<li><span style='color:green'>(stable)</span> public static final MeasureUnit MILE_PER_GALLON_IMPERIAL</li>
+<li><span style='color:green'>(stable)</span> public static final MeasureUnit MILLIGRAM_PER_DECILITER</li>
+</ul>
+</ul>
+
 
 <hr/>
-<h2>Added in ICU4J 59.0.1</h2>
+<h2>Added in ICU4J 59.1</h2>
+
+<h3>Package com.ibm.icu.text</h3>
+<ul>
+<li><span style='color:orange'>(draft)</span> public abstract class <i>CaseMap</i></li>
+<li><span style='color:orange'>(draft)</span> public static final class <i>CaseMap.Fold</i></li>
+<li><span style='color:orange'>(draft)</span> public static final class <i>CaseMap.Lower</i></li>
+<li><span style='color:orange'>(draft)</span> public static final class <i>CaseMap.Title</i></li>
+<li><span style='color:orange'>(draft)</span> public static final class <i>CaseMap.Upper</i></li>
+<li><span style='color:orange'>(draft)</span> public static interface <i>DecimalFormat.PropertySetter</i></li>
+<li><span style='color:gray'>(deprecated)</span> public class <i>DecimalFormat_ICU58</i></li>
+<li><span style='color:orange'>(draft)</span> public final class <i>Edits</i></li>
+<li><span style='color:orange'>(draft)</span> public static final class <i>Edits.Iterator</i></li>
+DecimalFormat
+<ul>
+<li><span style='color:orange'>(draft)</span> protected static final java.lang.ThreadLocal&lt;number.Properties&gt; threadLocalCurrencyProperties</li>
+<li><span style='color:orange'>(draft)</span> public java.lang.StringBuffer <i>format</i>(CurrencyAmount, java.lang.StringBuffer, java.text.FieldPosition)</li>
+<li><span style='color:green'>(stable)</span> public synchronized Currency <i>getCurrency</i>()</li>
+<li><span style='color:green'>(stable)</span> public synchronized int <i>getMaximumFractionDigits</i>()</li>
+<li><span style='color:green'>(stable)</span> public synchronized int <i>getMaximumIntegerDigits</i>()</li>
+<li><span style='color:green'>(stable)</span> public synchronized int <i>getMinimumFractionDigits</i>()</li>
+<li><span style='color:green'>(stable)</span> public synchronized int <i>getMinimumIntegerDigits</i>()</li>
+<li><span style='color:green'>(stable)</span> public synchronized boolean <i>isGroupingUsed</i>()</li>
+<li><span style='color:green'>(stable)</span> public synchronized boolean <i>isParseIntegerOnly</i>()</li>
+<li><span style='color:green'>(stable)</span> public synchronized boolean <i>isParseStrict</i>()</li>
+<li><span style='color:green'>(stable)</span> public synchronized void <i>setGroupingUsed</i>(boolean)</li>
+<li><span style='color:green'>(stable)</span> public synchronized void <i>setParseIntegerOnly</i>(boolean)</li>
+<li><span style='color:green'>(stable)</span> public synchronized void <i>setParseStrict</i>(boolean)</li>
+<li><span style='color:orange'>(draft)</span> public synchronized java.lang.String <i>toString</i>()</li>
+</ul>
+PluralRules.FixedDecimal
+<ul>
+<li><span style='color:orange'>(draft)</span> public boolean <i>isInfinite</i>()</li>
+<li><span style='color:orange'>(draft)</span> public boolean <i>isNaN</i>()</li>
+</ul>
+PluralRules.IFixedDecimal
+<ul>
+<li><span style='color:orange'>(draft)</span> public double <i>getPluralOperand</i>(PluralRules.Operand)</li>
+<li><span style='color:orange'>(draft)</span> public boolean <i>isInfinite</i>()</li>
+<li><span style='color:orange'>(draft)</span> public boolean <i>isNaN</i>()</li>
+</ul>
+PluralRules.Operand
+<ul>
+<li><span style='color:orange'>(draft)</span> public static final PluralRules.Operand f</li>
+<li><span style='color:orange'>(draft)</span> public static final PluralRules.Operand i</li>
+<li><span style='color:orange'>(draft)</span> public static final PluralRules.Operand j</li>
+<li><span style='color:orange'>(draft)</span> public static final PluralRules.Operand n</li>
+<li><span style='color:orange'>(draft)</span> public static final PluralRules.Operand t</li>
+<li><span style='color:orange'>(draft)</span> public static final PluralRules.Operand v</li>
+<li><span style='color:orange'>(draft)</span> public static final PluralRules.Operand w</li>
+</ul>
+</ul>
 
 <h3>Package com.ibm.icu.util</h3>
 <ul>
+Currency.CurrencyStringInfo
+<ul>
+<li><span style='color:orange'>(draft)</span> public <i>Currency.CurrencyStringInfo</i>(java.lang.String, java.lang.String)</li>
+<li><span style='color:orange'>(draft)</span> public java.lang.String <i>getCurrencyString</i>()</li>
+<li><span style='color:orange'>(draft)</span> public java.lang.String <i>getISOCode</i>()</li>
+</ul>
+LocaleMatcher
+<ul>
+<li><span style='color:orange'>(draft)</span> public int <i>distance</i>(ULocale, ULocale)</li>
+</ul>
 MeasureUnit
 <ul>
 <li><span style='color:orange'>(draft)</span> public static final MeasureUnit POINT</li>
@@ -48,6 +156,6 @@ MeasureUnit
 </ul>
 
 <hr/>
-<p><i><font size="-1">Contents generated by ReportAPI tool on Mon Jan 30 02:07:39 EST 2017<br/>© 2017 and later: Unicode, Inc. and others. License & terms of use: <a href="http://www.unicode.org/copyright.html#License">http://www.unicode.org/copyright.html#License</a></font></i></p>
+<p><i><font size="-1">Contents generated by ReportAPI tool on Mon Mar 20 16:20:05 EDT 2017<br/>© 2017 and later: Unicode, Inc. and others. License & terms of use: <a href="http://www.unicode.org/copyright.html#License">http://www.unicode.org/copyright.html#License</a></font></i></p>
 </body>
 </html>
index 84452d396254a1129029276fa0665654afafd4fc..3f3621b0631788152fac99e62a265504b866f4ee 100644 (file)
@@ -455,8 +455,7 @@ public abstract class DateFormat extends UFormat {
      * {@icu} FieldPosition selector for 'b' field alignment.
      * No related Calendar field.
      * This displays the fixed day period (am/pm/midnight/noon).
-     * @draft ICU 57
-     * @provisional This API might change or be removed in a future release.
+     * @stable ICU 57
      */
     final static int AM_PM_MIDNIGHT_NOON_FIELD = 35;
 
@@ -464,8 +463,7 @@ public abstract class DateFormat extends UFormat {
      * {@icu} FieldPosition selector for 'B' field alignment.
      * No related Calendar field.
      * This displays the flexible day period.
-     * @draft ICU 57
-     * @provisional This API might change or be removed in a future release.
+     * @stable ICU 57
      */
     final static int FLEXIBLE_DAY_PERIOD_FIELD = 36;
 
index 73ec0708f14ad9e3ad58441464d687d5dc7db4e7..ba28bfe18e173c63a15545e52be34b2bc1333b9f 100644 (file)
@@ -299,106 +299,91 @@ public final class RelativeDateTimeFormatter {
         /**
          * Specifies that relative unit is year, e.g. "last year",
          * "in 5 years".
-         * @draft ICU 57
-         * @provisional This API might change or be removed in a future release.
+         * @stable ICU 57
          */
         YEAR,
         /**
          * Specifies that relative unit is quarter, e.g. "last quarter",
          * "in 5 quarters".
-         * @draft ICU 57
-         * @provisional This API might change or be removed in a future release.
+         * @stable ICU 57
          */
         QUARTER,
         /**
          * Specifies that relative unit is month, e.g. "last month",
          * "in 5 months".
-         * @draft ICU 57
-         * @provisional This API might change or be removed in a future release.
+         * @stable ICU 57
          */
         MONTH,
         /**
          * Specifies that relative unit is week, e.g. "last week",
          * "in 5 weeks".
-         * @draft ICU 57
-         * @provisional This API might change or be removed in a future release.
+         * @stable ICU 57
          */
         WEEK,
         /**
          * Specifies that relative unit is day, e.g. "yesterday",
          * "in 5 days".
-         * @draft ICU 57
-         * @provisional This API might change or be removed in a future release.
+         * @stable ICU 57
          */
         DAY,
         /**
          * Specifies that relative unit is hour, e.g. "1 hour ago",
          * "in 5 hours".
-         * @draft ICU 57
-         * @provisional This API might change or be removed in a future release.
+         * @stable ICU 57
          */
         HOUR,
         /**
          * Specifies that relative unit is minute, e.g. "1 minute ago",
          * "in 5 minutes".
-         * @draft ICU 57
-         * @provisional This API might change or be removed in a future release.
+         * @stable ICU 57
          */
         MINUTE,
         /**
          * Specifies that relative unit is second, e.g. "1 second ago",
          * "in 5 seconds".
-         * @draft ICU 57
-         * @provisional This API might change or be removed in a future release.
+         * @stable ICU 57
          */
         SECOND,
         /**
          * Specifies that relative unit is Sunday, e.g. "last Sunday",
          * "this Sunday", "next Sunday", "in 5 Sundays".
-         * @draft ICU 57
-         * @provisional This API might change or be removed in a future release.
+         * @stable ICU 57
          */
         SUNDAY,
         /**
          * Specifies that relative unit is Monday, e.g. "last Monday",
          * "this Monday", "next Monday", "in 5 Mondays".
-         * @draft ICU 57
-         * @provisional This API might change or be removed in a future release.
+         * @stable ICU 57
          */
         MONDAY,
         /**
          * Specifies that relative unit is Tuesday, e.g. "last Tuesday",
          * "this Tuesday", "next Tuesday", "in 5 Tuesdays".
-         * @draft ICU 57
-         * @provisional This API might change or be removed in a future release.
+         * @stable ICU 57
          */
         TUESDAY,
         /**
          * Specifies that relative unit is Wednesday, e.g. "last Wednesday",
          * "this Wednesday", "next Wednesday", "in 5 Wednesdays".
-         * @draft ICU 57
-         * @provisional This API might change or be removed in a future release.
+         * @stable ICU 57
          */
         WEDNESDAY,
         /**
          * Specifies that relative unit is Thursday, e.g. "last Thursday",
          * "this Thursday", "next Thursday", "in 5 Thursdays".
-         * @draft ICU 57
-         * @provisional This API might change or be removed in a future release.
+         * @stable ICU 57
          */
         THURSDAY,
         /**
          * Specifies that relative unit is Friday, e.g. "last Friday",
          * "this Friday", "next Friday", "in 5 Fridays".
-         * @draft ICU 57
-         * @provisional This API might change or be removed in a future release.
+         * @stable ICU 57
          */
         FRIDAY,
         /**
          * Specifies that relative unit is Saturday, e.g. "last Saturday",
          * "this Saturday", "next Saturday", "in 5 Saturdays".
-         * @draft ICU 57
-         * @provisional This API might change or be removed in a future release.
+         * @stable ICU 57
          */
         SATURDAY,
     }
@@ -544,8 +529,7 @@ public final class RelativeDateTimeFormatter {
      *                  date, e.g. RelativeDateTimeUnit.WEEK,
      *                  RelativeDateTimeUnit.FRIDAY.
      * @return          The formatted string (may be empty in case of error)
-     * @draft ICU 57
-     * @provisional This API might change or be removed in a future release.
+     * @stable ICU 57
      */
     public String formatNumeric(double offset, RelativeDateTimeUnit unit) {
         // TODO:
@@ -625,8 +609,7 @@ public final class RelativeDateTimeFormatter {
      *                  date, e.g. RelativeDateTimeUnit.WEEK,
      *                  RelativeDateTimeUnit.FRIDAY.
      * @return          The formatted string (may be empty in case of error)
-     * @draft ICU 57
-     * @provisional This API might change or be removed in a future release.
+     * @stable ICU 57
      */
     public String format(double offset, RelativeDateTimeUnit unit) {
         // TODO:
index 00e9d064a5da5422c5a638b88bc8d71f8a11e669..3a20db7d04710d0b7d2c2aee26faf1e32e5d3849 100644 (file)
@@ -32,8 +32,7 @@ import com.ibm.icu.impl.SimpleFormatterImpl;
  *
  * @see MessageFormat
  * @see MessagePattern.ApostropheMode
- * @draft ICU 57
- * @provisional This API might change or be removed in a future release.
+ * @stable ICU 57
  */
 public final class SimpleFormatter {
     // For internal use in Java, use SimpleFormatterImpl directly instead:
@@ -57,8 +56,7 @@ public final class SimpleFormatter {
      * @param pattern The pattern string.
      * @return The new SimpleFormatter object.
      * @throws IllegalArgumentException for bad argument syntax.
-     * @draft ICU 57
-     * @provisional This API might change or be removed in a future release.
+     * @stable ICU 57
      */
     public static SimpleFormatter compile(CharSequence pattern) {
         return compileMinMaxArguments(pattern, 0, Integer.MAX_VALUE);
@@ -74,8 +72,7 @@ public final class SimpleFormatter {
      * @param max The pattern must have at most this many arguments.
      * @return The new SimpleFormatter object.
      * @throws IllegalArgumentException for bad argument syntax and too few or too many arguments.
-     * @draft ICU 57
-     * @provisional This API might change or be removed in a future release.
+     * @stable ICU 57
      */
     public static SimpleFormatter compileMinMaxArguments(CharSequence pattern, int min, int max) {
         StringBuilder sb = new StringBuilder();
@@ -85,8 +82,7 @@ public final class SimpleFormatter {
 
     /**
      * @return The max argument number + 1.
-     * @draft ICU 57
-     * @provisional This API might change or be removed in a future release.
+     * @stable ICU 57
      */
     public int getArgumentLimit() {
         return SimpleFormatterImpl.getArgumentLimit(compiledPattern);
@@ -94,8 +90,7 @@ public final class SimpleFormatter {
 
     /**
      * Formats the given values.
-     * @draft ICU 57
-     * @provisional This API might change or be removed in a future release.
+     * @stable ICU 57
      */
     public String format(CharSequence... values) {
         return SimpleFormatterImpl.formatCompiledPattern(compiledPattern, values);
@@ -114,8 +109,7 @@ public final class SimpleFormatter {
      *               values.length must be at least getArgumentLimit().
      *               Can be null if getArgumentLimit()==0.
      * @return appendTo
-     * @draft ICU 57
-     * @provisional This API might change or be removed in a future release.
+     * @stable ICU 57
      */
     public StringBuilder formatAndAppend(
             StringBuilder appendTo, int[] offsets, CharSequence... values) {
@@ -136,8 +130,7 @@ public final class SimpleFormatter {
      *               An argument value may be the same object as result.
      *               values.length must be at least getArgumentLimit().
      * @return result
-     * @draft ICU 57
-     * @provisional This API might change or be removed in a future release.
+     * @stable ICU 57
      */
     public StringBuilder formatAndReplace(
             StringBuilder result, int[] offsets, CharSequence... values) {
@@ -147,8 +140,7 @@ public final class SimpleFormatter {
     /**
      * Returns a string similar to the original pattern, only for debugging.
      *
-     * @draft ICU 57
-     * @provisional This API might change or be removed in a future release.
+     * @stable ICU 57
      */
     @Override
     public String toString() {
@@ -163,8 +155,7 @@ public final class SimpleFormatter {
      * Returns the pattern text with none of the arguments.
      * Like formatting with all-empty string values.
      *
-     * @draft ICU 57
-     * @provisional This API might change or be removed in a future release.
+     * @stable ICU 57
      */
     public String getTextWithNoArguments() {
         return SimpleFormatterImpl.getTextWithNoArguments(compiledPattern);
index 7249e67f06b474899791d8a2a6ad57f383935683..17513d01bea306c5146ce8d034b64fd7a6458341 100644 (file)
@@ -466,8 +466,7 @@ public class MeasureUnit implements Serializable {
 
     /**
      * Constant for unit of concentr: milligram-per-deciliter
-     * @draft ICU 57
-     * @provisional This API might change or be removed in a future release.
+     * @stable ICU 57
      */
     public static final MeasureUnit MILLIGRAM_PER_DECILITER = MeasureUnit.internalGetInstance("concentr", "milligram-per-deciliter");
 
@@ -505,8 +504,7 @@ public class MeasureUnit implements Serializable {
 
     /**
      * Constant for unit of consumption: mile-per-gallon-imperial
-     * @draft ICU 57
-     * @provisional This API might change or be removed in a future release.
+     * @stable ICU 57
      */
     public static final MeasureUnit MILE_PER_GALLON_IMPERIAL = MeasureUnit.internalGetInstance("consumption", "mile-per-gallon-imperial");
 
@@ -1127,8 +1125,7 @@ public class MeasureUnit implements Serializable {
 
     /**
      * Constant for unit of volume: gallon-imperial
-     * @draft ICU 57
-     * @provisional This API might change or be removed in a future release.
+     * @stable ICU 57
      */
     public static final MeasureUnit GALLON_IMPERIAL = MeasureUnit.internalGetInstance("volume", "gallon-imperial");