9 --> |
9 --> |
10 <!DOCTYPE concept |
10 <!DOCTYPE concept |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 <concept id="GUID-71DCEB48-8E8C-59A0-A99F-23245FF2DF13" xml:lang="en"><title>timezoneconversion: |
12 <concept id="GUID-71DCEB48-8E8C-59A0-A99F-23245FF2DF13" xml:lang="en"><title>timezoneconversion: |
13 Time Zone Conversion Example</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 Time Zone Conversion Example</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
14 <section><title>Download</title> <p>Click on the following link to download |
14 <section id="GUID-340A1745-6C2C-41E5-A637-346F32F11A21"><title>Download</title> <p>Click on the following link to download |
15 the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-c9019536-b967-4421-8221-150afb121307.zip" scope="external">TZExample.zip</xref></p><p>Click: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-c9019536-b967-4421-8221-150afb121307.html" scope="peer">browse</xref> to view the example code. </p> </section> |
15 the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-c9019536-b967-4421-8221-150afb121307.zip" scope="external">TZExample.zip</xref></p><p>Click: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-c9019536-b967-4421-8221-150afb121307.html" scope="peer">browse</xref> to view the example code. </p> </section> |
16 <section><title>Description</title> <p>This example code first connects to |
16 <section id="GUID-A36EB85A-A039-4396-BF31-2780D57E85F7"><title>Description</title> <p>This example code first connects to |
17 the time zone server (class <xref href="GUID-052221AD-916E-3E47-9510-AC0495A19A70.dita"><apiname>RTz</apiname></xref>). Then it uses <xref href="GUID-052221AD-916E-3E47-9510-AC0495A19A70.dita#GUID-052221AD-916E-3E47-9510-AC0495A19A70/GUID-A7D33D36-8AA5-3775-B4B8-36C30EF88DB0"><apiname>RTz::ConvertToLocalTime()</apiname></xref> to |
17 the time zone server (class <xref href="GUID-052221AD-916E-3E47-9510-AC0495A19A70.dita"><apiname>RTz</apiname></xref>). Then it uses <xref href="GUID-052221AD-916E-3E47-9510-AC0495A19A70.dita#GUID-052221AD-916E-3E47-9510-AC0495A19A70/GUID-A7D33D36-8AA5-3775-B4B8-36C30EF88DB0"><apiname>RTz::ConvertToLocalTime()</apiname></xref> to |
18 convert a UTC time to local time. The time to convert and the time zone to |
18 convert a UTC time to local time. The time to convert and the time zone to |
19 convert it to are randomly chosen. This demonstrates that the time zone server |
19 convert it to are randomly chosen. This demonstrates that the time zone server |
20 can convert any time, past, present or future, for any time zone, as long |
20 can convert any time, past, present or future, for any time zone, as long |
21 as a rule exists for the conversion. Conversion rules are stored in a native |
21 as a rule exists for the conversion. Conversion rules are stored in a native |
22 Symbian OS database that is a compressed form of the Olson time zone database |
22 Symbian database that is a compressed form of the Olson time |
23 (<xref href="http://www.twinsun.com/tz/tz-link.htm" scope="external">http://www.twinsun.com/tz/tz-link.htm</xref>). |
23 zone database (<xref href="http://www.twinsun.com/tz/tz-link.htm" scope="external">http://www.twinsun.com/tz/tz-link.htm</xref>). |
24 The database can be configured by phone manufacturers to save space. </p> <p>The |
24 The database can be configured by phone manufacturers to save space. </p> <p>The |
25 example then converts the current local time for the system time zone to the |
25 example then converts the current local time for the system time zone to the |
26 current local time for a different time zone. This is a two stage process. |
26 current local time for a different time zone. This is a two stage process. |
27 First, the local time is converted to UTC using <xref href="GUID-052221AD-916E-3E47-9510-AC0495A19A70.dita#GUID-052221AD-916E-3E47-9510-AC0495A19A70/GUID-645162AA-631E-3125-A002-82EB8D91DB08"><apiname>RTz::ConvertToUniversalTime()</apiname></xref>. |
27 First, the local time is converted to UTC using <xref href="GUID-052221AD-916E-3E47-9510-AC0495A19A70.dita#GUID-052221AD-916E-3E47-9510-AC0495A19A70/GUID-645162AA-631E-3125-A002-82EB8D91DB08"><apiname>RTz::ConvertToUniversalTime()</apiname></xref>. |
28 When converting between local and UTC times for the current system time zone, |
28 When converting between local and UTC times for the current system time zone, |
41 a specific time zone (either the time zone specified in the conversion function, |
41 a specific time zone (either the time zone specified in the conversion function, |
42 or the system time zone), on the client side, so avoiding the need for an |
42 or the system time zone), on the client side, so avoiding the need for an |
43 an IPC call for each conversion. <codeph>CTzConverter</codeph> is more efficient |
43 an IPC call for each conversion. <codeph>CTzConverter</codeph> is more efficient |
44 than <codeph>RTz</codeph> when doing multiple conversions for a single time |
44 than <codeph>RTz</codeph> when doing multiple conversions for a single time |
45 zone. </p> </section> |
45 zone. </p> </section> |
46 <section><title>Usage</title><p> This is a console application, so does not |
46 <section id="GUID-A56CA8E4-4794-41A4-9C12-F5867525DD8C"><title>Usage</title><p> This is a console application, so does not |
47 have a GUI. It builds an executable called<filepath> TZExample.exe</filepath> in |
47 have a GUI. It builds an executable called<filepath> TZExample.exe</filepath> in |
48 the standard location (<filepath>\epoc32\release\winscw\<build_variant></filepath> for |
48 the standard location (<filepath>\epoc32\release\winscw\<build_variant></filepath> for |
49 CodeWarrior). After launching the executable, depending on the emulator you |
49 CodeWarrior). After launching the executable, depending on the emulator you |
50 are using, you may need to task away from the app launcher/shell screen to |
50 are using, you may need to task away from the app launcher/shell screen to |
51 view the console.</p></section> |
51 view the console.</p></section> |
52 <section><title>Class Summary</title><p> <xref href="GUID-052221AD-916E-3E47-9510-AC0495A19A70.dita"><apiname>RTz</apiname></xref></p><p> <xref href="GUID-0B5453C5-76A2-31B2-A32C-2CDC1F3367CE.dita"><apiname>CTzId</apiname></xref> </p><p> <xref href="GUID-A2D3BA72-9B27-3BFF-950A-D7E3B2004821.dita"><apiname>TTime</apiname></xref> </p></section> |
52 <section id="GUID-2E27B7FB-A188-450C-8BA3-485FFB63F66C"><title>Class Summary</title><p> <xref href="GUID-052221AD-916E-3E47-9510-AC0495A19A70.dita"><apiname>RTz</apiname></xref></p><p> <xref href="GUID-0B5453C5-76A2-31B2-A32C-2CDC1F3367CE.dita"><apiname>CTzId</apiname></xref> </p><p> <xref href="GUID-A2D3BA72-9B27-3BFF-950A-D7E3B2004821.dita"><apiname>TTime</apiname></xref> </p></section> |
53 </conbody></concept> |
53 </conbody></concept> |