ICU-13052 ICU4J 59 API promotion draft.

X-SVN-Rev: 39886
This commit is contained in:
Yoshito Umaoka 2017-03-20 20:23:23 +00:00
parent 634c4a2023
commit 2879c80793
5 changed files with 149 additions and 72 deletions

View 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,29 +25,137 @@ 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>
<hr/>
<h2>Added in ICU4J 59.0.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.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>
</ul>
</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>

View 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;

View 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:

View 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);

View 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");