ICU-3477 add doc of obsolete zone IDs

X-SVN-Rev: 15570
This commit is contained in:
Alan Liu 2004-05-26 23:20:55 +00:00
parent 2ed4252e9d
commit ea3e53f99b
2 changed files with 207 additions and 0 deletions

View File

@ -293,6 +293,108 @@
For details please see the <a href=
"http://oss.software.ibm.com/icu/apiref/index.html">documentation</a> of
<code>u_init()</code> in the <code>unicode/uclean.h</code> header file.</p>
<h3><a name="News_TimeZone_IDs" id="News_TimeZone_IDs">TimeZone
Identifiers</a></h3>
<p>ICU supports over 500 TimeZone identifiers. Most of these are current
Olson identifiers (see TimeZone documentation). However, some of these
are obsolete names for current identifiers. There are two sources of
obsolete identifiers: the Olson database itself, and JDK legacy
identifiers. (For example, the Olson database defines "US/Pacific" as an
old identifier for "America/Los_Angeles". JDK 1.5 defines "PST" as a
legacy identifier equivalent to "America/Los_Angeles".) Currently, the
ICU TimeZone API does not distinguish between current identifiers and
obsolete identifiers. This section lists obsolete identifiers and their
modern equivalents.
</p>
<p>As of ICU 3.0 there are 136 obsolete Olson names (modern names given
in parentheses):
<font size="-1">
America/Atka (America/Adak), America/Ensenada (America/Tijuana),
America/Fort_Wayne (America/Indianapolis), America/Indiana/Indianapolis
(America/Indianapolis), America/Kentucky/Louisville (America/Louisville),
America/Knox_IN (America/Indiana/Knox), America/Porto_Acre
(America/Rio_Branco), America/Rosario (America/Cordoba), America/Shiprock
(America/Denver), America/Virgin (America/St_Thomas),
Antarctica/South_Pole (Antarctica/McMurdo), Arctic/Longyearbyen
(Europe/Oslo), Asia/Ashkhabad (Asia/Ashgabat), Asia/Chungking
(Asia/Chongqing), Asia/Dacca (Asia/Dhaka), Asia/Istanbul
(Europe/Istanbul), Asia/Macao (Asia/Macau), Asia/Tel_Aviv
(Asia/Jerusalem), Asia/Thimbu (Asia/Thimphu), Asia/Ujung_Pandang
(Asia/Makassar), Asia/Ulan_Bator (Asia/Ulaanbaatar), Atlantic/Jan_Mayen
(Europe/Oslo), Australia/ACT (Australia/Sydney), Australia/Canberra
(Australia/Sydney), Australia/LHI (Australia/Lord_Howe), Australia/NSW
(Australia/Sydney), Australia/North (Australia/Darwin),
Australia/Queensland (Australia/Brisbane), Australia/South
(Australia/Adelaide), Australia/Tasmania (Australia/Hobart),
Australia/Victoria (Australia/Melbourne), Australia/West
(Australia/Perth), Australia/Yancowinna (Australia/Broken_Hill),
Brazil/Acre (America/Porto_Acre), Brazil/DeNoronha (America/Noronha),
Brazil/East (America/Sao_Paulo), Brazil/West (America/Manaus), CST6CDT
(America/Chicago), Canada/Atlantic (America/Halifax), Canada/Central
(America/Winnipeg), Canada/East-Saskatchewan (America/Regina),
Canada/Eastern (America/Toronto), Canada/Mountain (America/Edmonton),
Canada/Newfoundland (America/St_Johns), Canada/Pacific
(America/Vancouver), Canada/Saskatchewan (America/Regina), Canada/Yukon
(America/Whitehorse), Chile/Continental (America/Santiago),
Chile/EasterIsland (Pacific/Easter), Cuba (America/Havana), EST
(America/Indianapolis), EST5EDT (America/New_York), Egypt (Africa/Cairo),
Eire (Europe/Dublin), Etc/GMT+0 (Etc/GMT), Etc/GMT-0 (Etc/GMT), Etc/GMT0
(Etc/GMT), Etc/Greenwich (Etc/GMT), Etc/Universal (Etc/UTC), Etc/Zulu
(Etc/UTC), Europe/Bratislava (Europe/Prague), Europe/Ljubljana
(Europe/Belgrade), Europe/Nicosia (Asia/Nicosia), Europe/San_Marino
(Europe/Rome), Europe/Sarajevo (Europe/Belgrade), Europe/Skopje
(Europe/Belgrade), Europe/Tiraspol (Europe/Chisinau), Europe/Vatican
(Europe/Rome), Europe/Zagreb (Europe/Belgrade), GB (Europe/London),
GB-Eire (Europe/London), GMT (Etc/GMT), GMT+0 (Etc/GMT+0), GMT-0
(Etc/GMT-0), GMT0 (Etc/GMT0), Greenwich (Etc/Greenwich), HST
(Pacific/Honolulu), Hongkong (Asia/Hong_Kong), Iceland
(Atlantic/Reykjavik), Iran (Asia/Tehran), Israel (Asia/Jerusalem),
Jamaica (America/Jamaica), Japan (Asia/Tokyo), Kwajalein
(Pacific/Kwajalein), Libya (Africa/Tripoli), MST (America/Phoenix),
MST7MDT (America/Denver), Mexico/BajaNorte (America/Tijuana),
Mexico/BajaSur (America/Mazatlan), Mexico/General (America/Mexico_City),
Mideast/Riyadh87 (Asia/Riyadh87), Mideast/Riyadh88 (Asia/Riyadh88),
Mideast/Riyadh89 (Asia/Riyadh89), NZ (Pacific/Auckland), NZ-CHAT
(Pacific/Chatham), Navajo (America/Denver), PRC (Asia/Shanghai), PST8PDT
(America/Los_Angeles), Pacific/Samoa (Pacific/Pago_Pago), Poland
(Europe/Warsaw), Portugal (Europe/Lisbon), ROC (Asia/Taipei), ROK
(Asia/Seoul), Singapore (Asia/Singapore), SystemV/AST4
(America/Puerto_Rico), SystemV/AST4ADT (America/Halifax), SystemV/CST6
(America/Regina), SystemV/CST6CDT (America/Chicago), SystemV/EST5
(America/Indianapolis), SystemV/EST5EDT (America/New_York), SystemV/HST10
(Pacific/Honolulu), SystemV/MST7 (America/Phoenix), SystemV/MST7MDT
(America/Denver), SystemV/PST8 (Pacific/Pitcairn), SystemV/PST8PDT
(America/Los_Angeles), SystemV/YST9 (Pacific/Gambier), SystemV/YST9YDT
(America/Anchorage), Turkey (Europe/Istanbul), UCT (Etc/UCT), US/Alaska
(America/Anchorage), US/Aleutian (America/Adak), US/Arizona
(America/Phoenix), US/Central (America/Chicago), US/East-Indiana
(America/Indianapolis), US/Eastern (America/New_York), US/Hawaii
(Pacific/Honolulu), US/Indiana-Starke (America/Indiana/Knox), US/Michigan
(America/Detroit), US/Mountain (America/Denver), US/Pacific
(America/Los_Angeles), US/Pacific-New (America/Los_Angeles), US/Samoa
(Pacific/Pago_Pago), UTC (Etc/UTC), Universal (Etc/Universal), W-SU
(Europe/Moscow), Zulu (Etc/Zulu).
</font></p>
<p>As of ICU 3.0 there are 25 legacy JDK identifiers (modern names given
in parentheses):
<font size="-1">
ACT (Australia/Darwin), AET (Australia/Sydney), AGT
(America/Buenos_Aires), ART (Africa/Cairo), AST (America/Anchorage), BET
(America/Sao_Paulo), BST (Asia/Dhaka), CAT (Africa/Harare), CNT
(America/St_Johns), CST (America/Chicago), CTT (Asia/Shanghai), EAT
(Africa/Addis_Ababa), ECT (Europe/Paris), IET (America/Indianapolis), IST
(Asia/Calcutta), JST (Asia/Tokyo), MIT (Pacific/Apia), NET
(Asia/Yerevan), NST (Pacific/Auckland), PLT (Asia/Karachi), PNT
(America/Phoenix), PRT (America/Puerto_Rico), PST (America/Los_Angeles),
SST (Pacific/Guadalcanal), VST (Asia/Saigon).
</font></p>
<hr>
<h2><a name="Download" href="#Download" id="Download">How To Download the

View File

@ -35,6 +35,7 @@ h3.doc { background: #CCCCFF }
<ul type="disc">
<li><a href="#introduction">Introduction to ICU4J</a></li>
<li><a href="#news">What Is New In This Release?</a></li>
<li><a href="#license">License Information</a></li>
<li><a href="#PlatformDependencies">Platform Dependencies</a></li>
<li><a href="#download">How to Download ICU4J</a></li>
@ -86,6 +87,110 @@ Java. For example, the Thai word-break is now in Java 1.4. However, if you
are using Java 1.3, you can use the ICU4J package until you upgrade to 1.4.
</p>
<h3 class="doc"><a NAME="news"></a>What Is New In This
Release?</h3>
<h4><a name="News_TimeZone_IDs" id="News_TimeZone_IDs">TimeZone
Identifiers</a></h4>
<p>ICU supports over 500 TimeZone identifiers. Most of these are current
Olson identifiers (see TimeZone documentation). However, some of these
are obsolete names for current identifiers. There are two sources of
obsolete identifiers: the Olson database itself, and JDK legacy
identifiers. (For example, the Olson database defines "US/Pacific" as an
old identifier for "America/Los_Angeles". JDK 1.5 defines "PST" as a
legacy identifier equivalent to "America/Los_Angeles".) Currently, the
ICU TimeZone API does not distinguish between current identifiers and
obsolete identifiers. This section lists obsolete identifiers and their
modern equivalents.
</p>
<p>As of ICU 3.0 there are 136 obsolete Olson names (modern names given
in parentheses):
<font size="-1">
America/Atka (America/Adak), America/Ensenada (America/Tijuana),
America/Fort_Wayne (America/Indianapolis), America/Indiana/Indianapolis
(America/Indianapolis), America/Kentucky/Louisville (America/Louisville),
America/Knox_IN (America/Indiana/Knox), America/Porto_Acre
(America/Rio_Branco), America/Rosario (America/Cordoba), America/Shiprock
(America/Denver), America/Virgin (America/St_Thomas),
Antarctica/South_Pole (Antarctica/McMurdo), Arctic/Longyearbyen
(Europe/Oslo), Asia/Ashkhabad (Asia/Ashgabat), Asia/Chungking
(Asia/Chongqing), Asia/Dacca (Asia/Dhaka), Asia/Istanbul
(Europe/Istanbul), Asia/Macao (Asia/Macau), Asia/Tel_Aviv
(Asia/Jerusalem), Asia/Thimbu (Asia/Thimphu), Asia/Ujung_Pandang
(Asia/Makassar), Asia/Ulan_Bator (Asia/Ulaanbaatar), Atlantic/Jan_Mayen
(Europe/Oslo), Australia/ACT (Australia/Sydney), Australia/Canberra
(Australia/Sydney), Australia/LHI (Australia/Lord_Howe), Australia/NSW
(Australia/Sydney), Australia/North (Australia/Darwin),
Australia/Queensland (Australia/Brisbane), Australia/South
(Australia/Adelaide), Australia/Tasmania (Australia/Hobart),
Australia/Victoria (Australia/Melbourne), Australia/West
(Australia/Perth), Australia/Yancowinna (Australia/Broken_Hill),
Brazil/Acre (America/Porto_Acre), Brazil/DeNoronha (America/Noronha),
Brazil/East (America/Sao_Paulo), Brazil/West (America/Manaus), CST6CDT
(America/Chicago), Canada/Atlantic (America/Halifax), Canada/Central
(America/Winnipeg), Canada/East-Saskatchewan (America/Regina),
Canada/Eastern (America/Toronto), Canada/Mountain (America/Edmonton),
Canada/Newfoundland (America/St_Johns), Canada/Pacific
(America/Vancouver), Canada/Saskatchewan (America/Regina), Canada/Yukon
(America/Whitehorse), Chile/Continental (America/Santiago),
Chile/EasterIsland (Pacific/Easter), Cuba (America/Havana), EST
(America/Indianapolis), EST5EDT (America/New_York), Egypt (Africa/Cairo),
Eire (Europe/Dublin), Etc/GMT+0 (Etc/GMT), Etc/GMT-0 (Etc/GMT), Etc/GMT0
(Etc/GMT), Etc/Greenwich (Etc/GMT), Etc/Universal (Etc/UTC), Etc/Zulu
(Etc/UTC), Europe/Bratislava (Europe/Prague), Europe/Ljubljana
(Europe/Belgrade), Europe/Nicosia (Asia/Nicosia), Europe/San_Marino
(Europe/Rome), Europe/Sarajevo (Europe/Belgrade), Europe/Skopje
(Europe/Belgrade), Europe/Tiraspol (Europe/Chisinau), Europe/Vatican
(Europe/Rome), Europe/Zagreb (Europe/Belgrade), GB (Europe/London),
GB-Eire (Europe/London), GMT (Etc/GMT), GMT+0 (Etc/GMT+0), GMT-0
(Etc/GMT-0), GMT0 (Etc/GMT0), Greenwich (Etc/Greenwich), HST
(Pacific/Honolulu), Hongkong (Asia/Hong_Kong), Iceland
(Atlantic/Reykjavik), Iran (Asia/Tehran), Israel (Asia/Jerusalem),
Jamaica (America/Jamaica), Japan (Asia/Tokyo), Kwajalein
(Pacific/Kwajalein), Libya (Africa/Tripoli), MST (America/Phoenix),
MST7MDT (America/Denver), Mexico/BajaNorte (America/Tijuana),
Mexico/BajaSur (America/Mazatlan), Mexico/General (America/Mexico_City),
Mideast/Riyadh87 (Asia/Riyadh87), Mideast/Riyadh88 (Asia/Riyadh88),
Mideast/Riyadh89 (Asia/Riyadh89), NZ (Pacific/Auckland), NZ-CHAT
(Pacific/Chatham), Navajo (America/Denver), PRC (Asia/Shanghai), PST8PDT
(America/Los_Angeles), Pacific/Samoa (Pacific/Pago_Pago), Poland
(Europe/Warsaw), Portugal (Europe/Lisbon), ROC (Asia/Taipei), ROK
(Asia/Seoul), Singapore (Asia/Singapore), SystemV/AST4
(America/Puerto_Rico), SystemV/AST4ADT (America/Halifax), SystemV/CST6
(America/Regina), SystemV/CST6CDT (America/Chicago), SystemV/EST5
(America/Indianapolis), SystemV/EST5EDT (America/New_York), SystemV/HST10
(Pacific/Honolulu), SystemV/MST7 (America/Phoenix), SystemV/MST7MDT
(America/Denver), SystemV/PST8 (Pacific/Pitcairn), SystemV/PST8PDT
(America/Los_Angeles), SystemV/YST9 (Pacific/Gambier), SystemV/YST9YDT
(America/Anchorage), Turkey (Europe/Istanbul), UCT (Etc/UCT), US/Alaska
(America/Anchorage), US/Aleutian (America/Adak), US/Arizona
(America/Phoenix), US/Central (America/Chicago), US/East-Indiana
(America/Indianapolis), US/Eastern (America/New_York), US/Hawaii
(Pacific/Honolulu), US/Indiana-Starke (America/Indiana/Knox), US/Michigan
(America/Detroit), US/Mountain (America/Denver), US/Pacific
(America/Los_Angeles), US/Pacific-New (America/Los_Angeles), US/Samoa
(Pacific/Pago_Pago), UTC (Etc/UTC), Universal (Etc/Universal), W-SU
(Europe/Moscow), Zulu (Etc/Zulu).
</font></p>
<p>As of ICU 3.0 there are 25 legacy JDK identifiers (modern names given
in parentheses):
<font size="-1">
ACT (Australia/Darwin), AET (Australia/Sydney), AGT
(America/Buenos_Aires), ART (Africa/Cairo), AST (America/Anchorage), BET
(America/Sao_Paulo), BST (Asia/Dhaka), CAT (Africa/Harare), CNT
(America/St_Johns), CST (America/Chicago), CTT (Asia/Shanghai), EAT
(Africa/Addis_Ababa), ECT (Europe/Paris), IET (America/Indianapolis), IST
(Asia/Calcutta), JST (Asia/Tokyo), MIT (Pacific/Apia), NET
(Asia/Yerevan), NST (Pacific/Auckland), PLT (Asia/Karachi), PNT
(America/Phoenix), PRT (America/Puerto_Rico), PST (America/Los_Angeles),
SST (Pacific/Guadalcanal), VST (Asia/Saigon).
</font></p>
<h3 class="doc"><a name=license></a>License Information</h3>
<p>
The ICU projects (ICU4C and ICU4J) use the X license.&nbsp; The X license is a <b>non-viral</b> and recommended free software license that is compatible with the GNU GPL license.&nbsp; This became effective with release 1.8.1 of ICU4C and release 1.3.1 of ICU4J in mid-2001. All new ICU releases will adopt the X license; previous ICU releases continue to utilize the IPL (IBM Public License).&nbsp; Users of previous releases of ICU who want to adopt new ICU releases will need to accept the terms and conditions of the X license.