Symbian3/SDK/Source/GUID-043A9408-1A97-4122-9364-965ECC08B40F.dita
changeset 13 48780e181b38
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-043A9408-1A97-4122-9364-965ECC08B40F.dita	Tue Jul 20 12:00:49 2010 +0100
@@ -0,0 +1,31 @@
+<?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 task
+  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
+<task id="GUID-043A9408-1A97-4122-9364-965ECC08B40F" xml:lang="en"><title>Converting
+from any local time to UTC</title><prolog><metadata><keywords/></metadata></prolog><taskbody>
+<steps-unordered id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-10-1-12-1-1-7-1-5-1-3-1-6-1-2-1">
+<step id="GUID-9A69E5AD-E938-4092-A8C2-CB65C37C8962-GENID-1-10-1-12-1-1-7-1-5-1-3-1-6-1-2-1-1"><cmd>To convert the local
+time of a non-system time zone to UTC, use <xref href="GUID-37A4A4ED-FFF8-3C98-B028-EA1947EA7BEF.dita#GUID-37A4A4ED-FFF8-3C98-B028-EA1947EA7BEF/GUID-F2FCFD02-8FF3-3171-AF90-9755C00A87F8"><apiname>CTzConverter::ConvertToUniversalTime()</apiname></xref>,
+specifying the time zone to convert from: </cmd>
+<stepxmp><p><codeblock xml:space="preserve">TInt errCode = myConverter-&gt;ConvertToUniversalTime(myTime, myZoneId); 
+</codeblock></p></stepxmp>
+<info><p>These time conversions internally do the following:  <ul>
+<li><p>fetch a number of 'actualized' rules applicable to the years around
+the supplied time and zone, where an 'actualized' rule defines a single and
+specific time of year when local time changes. It is derived from the encoded
+day rule defined in the Olson’s TZ database RULE. </p></li>
+<li><p>cache these rules for subsequent use.</p></li>
+<li><p>identify which rule immediately precedes the time supplied.</p></li>
+<li><p>apply the appropriate offsets defined by this rule.</p></li>
+</ul></p></info>
+</step>
+</steps-unordered>
+</taskbody></task>
\ No newline at end of file