Symbian3/SDK/Source/GUID-A0E21681-F1EF-4E79-965A-040AC7D72A01.dita
changeset 13 48780e181b38
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-A0E21681-F1EF-4E79-965A-040AC7D72A01.dita	Tue Jul 20 12:00:49 2010 +0100
@@ -0,0 +1,69 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License 
+"Eclipse Public License v1.0" which accompanies this distribution, 
+and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
+<!-- Initial Contributors:
+    Nokia Corporation - initial contribution.
+Contributors: 
+-->
+<!DOCTYPE concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-A0E21681-F1EF-4E79-965A-040AC7D72A01" xml:lang="en"><title>Time zone conversion overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>This document describes the Symbian platform time zone conversion
+component.</p>
+<p/>
+<section id="GUID-17E41393-8170-4FA6-B09C-E07A581CF79A"><title>About
+time zones and daylight saving time</title><p><b>Time zones </b></p><p>Time zones are regions that have adopted the same standard time.
+All time zones are defined relative to UTC (Coordinated Universal
+Time) which is the international time standard. See <xref format="html" href="http://www.ghcc.msfc.nasa.gov/utc.html" scope="external">http://www.ghcc.msfc.nasa.gov/utc.html</xref> for
+more details. </p>The time for a location is given relative to UTC.
+For example:<ul>
+<li><p>Mumbai, India: UTC + 5:30 (For example, if it is 12:00 UTC,
+then it is 17:30 in Mumbai) </p></li>
+<li><p>Tokyo, Japan: UTC + 9 (For example, if it is 12:00 UTC, then
+it is 21:00 in Tokyo)</p></li>
+</ul><note>The local time may need to be adjusted due to the use of
+a daylight saving time offset. </note><p>The list of time zones used
+within a country are found in Time zone list. Select a country to
+view all the time zones used within that country. The time zones follow
+a "Location/Area" format, with "Location" being a continent or geographic
+region of the world and "Area" being a time zone region within that
+location, for example, "Europe/Vienna". </p><p><b>Local time</b></p><p>The local time is the time according to the local time zone (the
+place where the phone user is physically located). The local time
+is sometimes referred to as "wall clock" time.   </p><p>If local time
+is 10:00 hours in the US Eastern time zone, then the local time in
+the US Pacific time zone is 07:00 hours. This is because US Eastern
+Time is 4 hours behind UTC (UTC -4) and US Pacific Time is 7 hours
+behind UTC (UTC –7 ).  </p><p>If a phone user’s normal location is
+in the US Eastern time zone, and travels to a location in the US Pacific
+time zone, the phone time zone should be changed to US Pacific Time.
+  </p><p>The system time zone is the time zone to which the device
+is set.</p> </section>
+<section id="GUID-80A22B2A-2ABE-4E8B-B4E3-FDAC586F0B9B"><title>Time
+zone conversion</title><p>The time zone component allows you to set
+the system time zone and to convert time between UTC and any time,
+past, present or future, for any time zone, as long as a rule exists
+for the conversion. The change rules include when to change to and
+from daylight saving time for each time zone.   </p><p>The time zone
+rules are provided in a Symbian-native database which is created from
+Olson’s TZ database. It can be configured by device manufacturers
+to save space. The time zone rules for the current time zone are cached
+by the time zone server so that they are quicker to access for future
+conversions.   </p><p>Using the time zone component you can do the
+following:  </p><ul>
+<li><p>configure the current local time zone.</p></li>
+<li><p>convert a UTC time to the local time for the system time zone.</p></li>
+<li><p>convert a UTC time to the local time for a time zone provided
+by the user.</p></li>
+<li><p>convert the local time for the system time zone to UTC.</p></li>
+<li><p>convert the local time for any time zone provided by the user
+to UTC.</p></li>
+</ul><p>The key classes involved are <codeph>CTzId</codeph>, <codeph>RTz</codeph> and <codeph>CTzConverter</codeph>.  </p><fig id="GUID-E9AB8158-B0A4-47FA-A9C2-23E697B04433">
+<title>Class diagram for Time zone Conversion</title>
+<image href="GUID-CE7DA679-D441-4843-A81B-2A60440B50E8_d0e146989_href.png" placement="inline"/>
+</fig><p><b> See also</b></p><ul>
+<li><p><xref href="GUID-DF4D7DFF-ECA9-40CF-9F3B-4BBC3F8162E4.dita">Converting
+between UTC and local time</xref></p></li>
+</ul></section>
+</conbody></concept>
\ No newline at end of file