Symbian3/SDK/Source/GUID-043A9408-1A97-4122-9364-965ECC08B40F.dita
author Dominic Pinkman <dominic.pinkman@nokia.com>
Tue, 20 Jul 2010 12:00:49 +0100
changeset 13 48780e181b38
permissions -rw-r--r--
Week 28 contribution of SDK documentation content. See release notes for details. Fixes bugs Bug 1897 and Bug 1522.

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