organicmaps/icu
13
Fork 0
mirror of https://github.com/unicode-org/icu.git synced 2025-04-14 09:21:03 +00:00
Code Issues 1 Projects Releases Wiki Activity Actions 1

ICU-5801 Update readme to address the timezone format roundtrip problem and the know Bidi test failure on Java 1.4/1.4.1.

Browse source 
X-SVN-Rev: 22661
This commit is contained in:
Yoshito Umaoka 2007-09-12 19:12:00 +00:00
parent acda067574
commit c9d43a6db5
1 changed files with 26 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
icu4j/readme.html
View file

@ -145,6 +145,25 @@ you can still run all of the Ant standard build targets in build.xml and make IC
binaries. The build script detects the current Java version and comments out code
blocks including references to J2SE 5.0 only types.</p>
<p>
<p><b>Changes to timezone text formatting and parsing</b>
<p>In ICU 3.8, the behavior of date formatting and parsing has changed significantly,
perhaps requiring recoding on your part depending on your usage. The goal of making
the change was to return more understandable results from formatting timezones, but
a byproduct is that the result from formatting with strings z, zzzz, v or vvvv are
no longer unique, and thus no longer roundtrips. That is, if you use a date format
with one of these strings, producing a certain output, you can no longer parse that
output and expect to recover the original timezone.
<p>What you will be able to get is a related, "best fit" mapping for the name, based
on the region associated with the current locale and the mappings found in CLDR's
supplemental data: for example, if you format the time zone "America/Denver",
getting "Heure des Rocheuses" in French, and then parse, the resulting time zone
would be "America/Denver" unless the locale in use has the region "CA" (such as
en-CA or fr-CA), in which case "America/Edmonton" would be retrieved.
<p>If you require roundtripping, you will need to change your code to use "VVVV"
instead. If you are working with date patterns based on a locale, then the workaround
is to use the DateTimePatternGenerator to convert the format you get for a locale to
using "VVVV".
<p>
<p><b>New features</b>
<p>
See the <a href="http://www.icu-project.org/download/">ICU 3.8 download page</a> about new features in this release.
@ -312,6 +331,13 @@ used by the ICU development team.
<td align="center" bgcolor="#EEEEFF">Rarely tested</td>
</tr>
</table>
<p><b>Note</b>: The ICU4J test case Bidi/TestCompatibility/testCompatibility is known
to fail on J2SE 1.4 and 1.4.1 runtime environment. The test case verifies Bidi class
compatibility between Java and ICU. However, the implementation of J2SE Bidi class
had some problems in these releases, therefore, the test detects differences and
reports some errors. This is not a real issue and ICU4J users who want to use ICU4J
Bidi class on J2SE 1.4/1.4.1 environment can safely ignore the test failure. The J2SE
Bidi implementation problem was resolved in J2SE 1.4.2 or later versions.
<h3 class="doc"><a name="download"></a>How to Download ICU4J</h3>
<p>There are two ways to download the ICU4J releases.