<?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-12-1-12-1-1-8-1-5-1-3-1-6-1-2-1">

<step id="GUID-9A69E5AD-E938-4092-A8C2-CB65C37C8962-GENID-1-12-1-12-1-1-8-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>