From 1fb3fb2d1272a81b1d4b1a7cd923d70cd4a013d4 Mon Sep 17 00:00:00 2001 From: Yoshito Umaoka Date: Fri, 14 Sep 2007 03:06:52 +0000 Subject: [PATCH] ICU-5801 Update readme.html to put link to the user guide about the time zone formatting issue. The previous description was incorrect because of yet another bug. X-SVN-Rev: 22678 --- icu4j/readme.html | 23 +++++------------------ 1 file changed, 5 insertions(+), 18 deletions(-) diff --git a/icu4j/readme.html b/icu4j/readme.html index 687a05d837..2a8deea376 100644 --- a/icu4j/readme.html +++ b/icu4j/readme.html @@ -145,24 +145,11 @@ 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.

-

Changes to timezone text formatting and parsing -

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. -

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. -

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". +

Changes to timezone formatting and parsing +

In ICU 3.8, the behavior of date formatting and parsing has changed +significantly, perhaps requiring recoding on your part depending on your +usage. For more information, see +Formatting Dates and Times in the User Guide.

New features