<body style="background-color: rgb(255, 255, 255);" lang="EN-US"
link="#0000ff" vlink="#800080">
<h1>International Components for Unicode for Java (ICU4J)</h1>
-<h2>Read Me for ICU4J 66.1</h2>
-(Last Update: 2020-Mar-02)
+<h2>Read Me for ICU4J 67.1</h2>
+(Last Update: 2020-Apr-1)
<hr size="2" width="100%">
<p>
<b>Note:</b> This is major release of ICU4J. It contains bug fixes and adds implementations
of inherited API and introduces new API or functionality.
-<!-- <b>Note:</b> This is a preview release of ICU4J 66.
+<!-- <b>Note:</b> This is a preview release of ICU4J 67.
The contents of this document may not reflect the recent changes done
-for ICU 66 development. It is not recommended for production use. -->
-<!-- <b>Note:</b> This is a development milestone of ICU4J 66.
+for ICU 67 development. It is not recommended for production use. -->
+<!-- <b>Note:</b> This is a development milestone of ICU4J 67.
The contents of this document may not reflect the recent changes done
-for ICU 66 development. It is not recommended for production use. -->
-<!-- <b>Note:</b> This is a release candidate of ICU4J 66.
+for ICU 67 development. It is not recommended for production use. -->
+<!-- <b>Note:</b> This is a release candidate of ICU4J 67.
The contents of this document may not reflect the recent changes done
-for ICU 66 development. This release candidate is intended for those
-wishing to verify ICU 66 integration before final release. It is not
+for ICU 67 development. This release candidate is intended for those
+wishing to verify ICU 67 integration before final release. It is not
recommended for production use. -->
</p>
<p>For the most recent release, see the <a
</p>
<ul>
<li><a
- href="http://www.icu-project.org/userguide/Collate_Intro.html"><b>Collation</b></a>
+ href="http://userguide.icu-project.org/collation"><b>Collation</b></a>
– rule-based, up-to-date Unicode Collation Algorithm (UCA) sorting order<br>
For fast multilingual string comparison; faster
and more complete than
the J2SE implementation</li>
- <li><a href="http://www.icu-project.org/userguide/charsetDetection.html"><b>Charset
+ <li><a href="http://userguide.icu-project.org/conversion/detection"><b>Charset
Detection</b></a> – Recognition of various single and multibyte charsets<br>
Useful for recognizing untagged text data</li>
<li><a
- href="http://www.icu-project.org/userguide/unicodeSet.html"><b>UnicodeSet</b></a>
+ href="http://userguide.icu-project.org/strings/unicodeset"><b>UnicodeSet</b></a>
– standard set operations optimized for sets of Unicode characters<br>
UnicodeSets can be built from string patterns
using any Unicode properties.</li>
- <li><a href="http://www.icu-project.org/userguide/Transform.html"><b>Transforms</b></a>
+ <li><a href="http://userguide.icu-project.org/transforms"><b>Transforms</b></a>
– a flexible mechanism for Unicode text conversions<br>
Including Full/Halfwidth conversions,
Normalization, Case conversions, Hex
conversions, and transliterations between scripts (50+ pairs)</li>
<li><a
- href="http://www.icu-project.org/userguide/normalization.html"><b>Unicode
+ href="http://userguide.icu-project.org/transforms/normalization"><b>Unicode
Normalization</b></a> – NFC, NFD, NFKD, NFKC<br>
For canonical text representations, needed for
XML and the net</li>
<li><a
- href="http://www.icu-project.org/userguide/dateCalendar.html"><b>International
+ href="http://userguide.icu-project.org/datetime/calendar"><b>International
Calendars</b></a> – Arabic, Buddhist, Chinese, Hebrew, Japanese, Ethiopic, Islamic, Coptic and other calendars<br>
Required for correct presentation of dates in
certain countries</li>
<li><a
- href="http://www.icu-project.org/userguide/formatNumbers.html"><b>Date
+ href="http://userguide.icu-project.org/formatparse/datetime"><b>Date
Format
Enhancements</b></a> – Date/time pattern generator, Relative date formatting, etc.<br>
Enhancements to the normal Java date
formatting.</li>
<li><a
- href="http://www.icu-project.org/userguide/formatNumbers.html"><b>Number
+ href="http://userguide.icu-project.org/formatparse/numbers"><b>Number
Format
Enhancements</b></a> – Scientific Notation, Spelled-out, Compact decimal format, etc.<br>
Enhancements to the normal Java number
formatting. The spell-out format is
used for checks and similar documents</li>
<li><a
- href="http://www.icu-project.org/userguide/boundaryAnalysis.html"><b>Enhanced
+ href="http://userguide.icu-project.org/boundaryanalysis"><b>Enhanced
Word-Break Detection</b></a> – Rule-based, supports Thai, Khmer, Chinese, etc.<br>
Required for correct support of Thai</li>
<li><a
- href="http://www.icu-project.org/userguide/compression.html"><b>Unicode
+ href="http://userguide.icu-project.org/conversion/compression"><b>Unicode
Text
Compression</b></a> – Standard compression of Unicode text<br>
Suitable for large numbers of small fields,
where LZW and similar schemes
do not apply</li>
<li><a
- href="http://www.icu-project.org/userguide/conversion.html"><b>Charset Conversion</b></a> – Conversion to and from different charsets.<br>
+ href="http://userguide.icu-project.org/conversion"><b>Charset Conversion</b></a> – Conversion to and from different charsets.<br>
Plugs into Java CharsetProvider Service Provider Interface (SPI)</li>
</ul>
<h2 class="doc"><a name="changes"></a>Changes In This Release</h2>
-<p>This release updates to Unicode 13 beta, CLDR 36.1, and includes some bug fixes.
-This is a low-impact release with no other significant feature additions or implementation changes.</p>
-
-<p>See the <a href="http://site.icu-project.org/download/66">ICU 66 download page</a>
+<p>See the <a href="http://site.icu-project.org/download/67">ICU 67 download page</a>
for more informantion about changes in this release.</p>
<p>The list of API changes since the previous ICU4J release is available
<a href="APIChangeReport.html">here</a>.</p>
</p>
<h2 class="doc"><a name="PlatformDependencies"></a>Platform Dependencies</h2>
<p>
-The minimum Java runtime version supported by ICU4J 66 is version 7. Java runtime version 6 is not supported.
+The minimum Java runtime version supported by ICU4J 67 is version 7. Java runtime version 6 is not supported.
</p>
<p>
ICU4J since version 63 depend on J2SE 7 functionality. Therefore, ICU4J only runs on
-JRE version 7 or later. ICU4J 66 is tested on JRE 7, 8, 9, 10 and 11.
+JRE version 7 or later. ICU4J 67 is tested on JRE 7, 8, 9, 10 and 11.
</p>
<h2 class="doc"><a name="download"></a>How to Download ICU4J</h2>
<dependency>
<groupId>com.ibm.icu</groupId>
<artifactId>icu4j</artifactId>
- <version>66.1</version>
+ <version>67.1</version>
</dependency>
<dependency>
<groupId>com.ibm.icu</groupId>
<artifactId>icu4j-charset</artifactId>
- <version>66.1</version>
+ <version>67.1</version>
</dependency>
<dependency>
<groupId>com.ibm.icu</groupId>
<artifactId>icu4j-localespi</artifactId>
- <version>66.1</version>
+ <version>67.1</version>
</dependency>
</pre>
</ul>
</table>
<h2 class="doc"><a name="API"></a>Where to get Documentation</h2>
-<p>The <a href="http://www.icu-project.org/userguide/">ICU user's
+<p>The <a href="http://userguide.icu-project.org/">ICU user's
guide</a> contains lots of general information about ICU, in its C,
C++, and Java incarnations.</p>
<p>The complete API documentation for ICU4J (javadoc) is available on
to the appropriate java options.</p>
<p><b>Eclipse users:</b> See the ICU4J site for information on<a
- href="http://www.icu-project.org/docs/eclipse_howto/eclipse_howto.html">
+ href="http://site.icu-project.org/setup/eclipse">
how to configure Eclipse</a> to build and develop ICU4J on Eclipse IDE.</p>
<p><b>Note:</b> To install and configure ICU4J Locale Service Provider, please refer the user guide
organization
of the data in ICU4J.</p>
<ul>
- <li>The primary <b>locale data</b> is under the directory <tt>icudt66b</tt>,
+ <li>The primary <b>locale data</b> is under the directory <tt>icudt67b</tt>,
as a set of <tt>".res"</tt> files whose names are the locale identifiers.
Locale naming is documented the <code>com.ibm.icu.util.ULocale</code>
class, and the use of these names in searching for resources is documented
in <code>com.ibm.icu.util.UResourceBundle</code>.</li>
- <li>The <b>break iterator data</b> is under the directory <tt>icudt66b/brkitr</tt>,
+ <li>The <b>break iterator data</b> is under the directory <tt>icudt67b/brkitr</tt>,
as a set of <tt>".res"</tt>, <tt>".brk"</tt> and <tt>".dict"</tt> files.</li>
- <li>The <b>collation data</b> is under the directory <tt>icudt66b/coll</tt>,
+ <li>The <b>collation data</b> is under the directory <tt>icudt67b/coll</tt>,
as a set of <tt>".res"</tt> files.</li>
- <li>The <b>currency display name data</b> is under the directory <tt>icudt66b/curr</tt>,
+ <li>The <b>currency display name data</b> is under the directory <tt>icudt67b/curr</tt>,
as a set of <tt>".res"</tt> files.</li>
- <li>The <b>language display name data</b> is under the directory <tt>icudt66b/lang</tt>,
+ <li>The <b>language display name data</b> is under the directory <tt>icudt67b/lang</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>rule-based number format data</b> is under the directory
- <tt>icudt66b/rbnf</tt>, as a set of <tt>".res"</tt> files.
+ <tt>icudt67b/rbnf</tt>, as a set of <tt>".res"</tt> files.
- <li>The <b>region display name data</b> is under the directory <tt>icudt66b/region</tt>,
+ <li>The <b>region display name data</b> is under the directory <tt>icudt67b/region</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>rule-based transliterator data</b> is under the directory
- <tt>icudt66b/translit</tt>, as a set of <tt>".res"</tt> files.</li>
+ <tt>icudt67b/translit</tt>, as a set of <tt>".res"</tt> files.</li>
- <li>The <b>measurement unit data</b> is under the directory <tt>icudt66b/unit</tt>,
+ <li>The <b>measurement unit data</b> is under the directory <tt>icudt67b/unit</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>time zone display name data</b> is under the directory
- <tt>icudt66b/zone</tt>, as a set of <tt>".res"</tt> files.</li>
+ <tt>icudt67b/zone</tt>, as a set of <tt>".res"</tt> files.</li>
<li>The <b>character property data</b> and default <b>unicode collation algorithm
- (UCA) data</b> is found under the directory <tt>icudt66b</tt>, as a set of
+ (UCA) data</b> is found under the directory <tt>icudt67b</tt>, as a set of
<tt>".icu"</tt> files. </li>
- <li>The <b>normalization data</b> is found under the directory <tt>icudt66b</tt>,
+ <li>The <b>normalization data</b> is found under the directory <tt>icudt67b</tt>,
as a set of <tt>".nrm"</tt> files. </li>
<li>The <b>character set converter data</b> is under the directory
- <tt>icudt66b</tt>, as a set of <tt>".cnv"</tt> files. These files are
+ <tt>icudt67b</tt>, as a set of <tt>".cnv"</tt> files. These files are
currently included only in icu-charset.jar.</li>
<li>The <b>time zone rule data</b> is under the directory
- <tt>icudt66b</tt>, as <tt>zoneinfo64.res</tt>.</li>
+ <tt>icudt67b</tt>, as <tt>zoneinfo64.res</tt>.</li>
- <li>The <b>holiday data</b> is under the directory <tt>icudt66b</tt>,
+ <li>The <b>holiday data</b> is under the directory <tt>icudt67b</tt>,
as a set of <tt>".class"</tt> files, named <tt>"HolidayBundle_"</tt>
followed by the locale ID.</li>
<h5> Generating Data from CLDR </h5>
<I> Note: This procedure assumes that all 3 sources are present</I>
<ol>
- <li>Checkout or download CLDR version 'release-36'</li>
- <li>Checkout ICU with tag 'release-66-1'</li>
+ <li>Checkout or download CLDR version 'release-37'</li>
+ <li>Checkout ICU with tag 'release-67-1'</li>
<li>cd to icu4c/source/data directory</li>
<li>Follow the instructions in icu4c/source/data/cldr-icu-readme.txt</li>
<li>Rebuild ICU4C with the newly generated data.</li>