Symbian3/SDK/Source/GUID-3F7142D6-261B-5FB9-888A-1A9BB51B67E5.dita
changeset 7 51a74ef9ed63
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-3F7142D6-261B-5FB9-888A-1A9BB51B67E5.dita	Wed Mar 31 11:11:55 2010 +0100
@@ -0,0 +1,52 @@
+<?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-3F7142D6-261B-5FB9-888A-1A9BB51B67E5" xml:lang="en"><title>Using
+Date and Time Utilities </title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>Stores dates in universal time format and supports the parsing of dates. </p>
+<section><title>Introduction</title><p><xref href="GUID-156E9C02-99AD-3C63-80AD-939A6DFB08B1.dita"><apiname>TInternetDate</apiname></xref> class
+stores the date in universal time and provides the functionality to parse
+internet style dates in different formats into <xref href="GUID-13A9DD2B-8ABC-3D62-B54E-4F5DD5B9228B.dita"><apiname>TDateTime</apiname></xref> and
+RFC 1123 dates. This class handles the 8-bit descriptors only. </p><p><xref href="GUID-156E9C02-99AD-3C63-80AD-939A6DFB08B1.dita"><apiname>TInternetDate</apiname></xref> supports
+parsing of the following date time formats: </p><ul>
+<li><p>Sun, 06 Nov 1994 08:49:37 GMT, RFC 822 and RFC 1123 </p></li>
+<li><p>Sunday, 06-Nov-94 08:49:37 GMT, RFC 850 </p></li>
+<li><p>Sun Nov 6 08:49:37 1994 ANSI C's asctime() format </p></li>
+</ul> </section>
+<section><title>Converting date to text format </title><p>The following code
+fragment constructs a <xref href="GUID-156E9C02-99AD-3C63-80AD-939A6DFB08B1.dita"><apiname>TInternetDate</apiname></xref> object from a <xref href="GUID-13A9DD2B-8ABC-3D62-B54E-4F5DD5B9228B.dita"><apiname>TDateTime</apiname></xref> object.
+It converts the date '<userinput>2006,EJanuary,17,06,36,30,000000</userinput>'
+to the text form, that is '<userinput>Wed, 17 Jan 2006 06:36:30 GMT</userinput>'. </p><codeblock xml:space="preserve">//create a date time object
+TDateTime time(2006,EJanuary,17,06,36,30,000000);  TInternetDate internetDate(time);
+
+//get the text form "Wed, 17 Jan 2006 06:36:30 GMT"
+HBufC8* textDate = internetDate.InternetDateTimeL(TInternetDate::ERfc1123Format);
+CleanupStack::PushL(textDate);
+
+//use textDate here
+CleanupStack::PopAndDestroy(textDate);
+</codeblock></section>
+<section><title>Setting text form of date </title><p>Use <xref href="GUID-156E9C02-99AD-3C63-80AD-939A6DFB08B1.dita#GUID-156E9C02-99AD-3C63-80AD-939A6DFB08B1/GUID-62720E45-43B1-38A5-992F-74FFD953CAF2"><apiname>TInternetDate::SetDateL()</apiname></xref> to
+set the text from of the date. Construct a <xref href="GUID-156E9C02-99AD-3C63-80AD-939A6DFB08B1.dita"><apiname>TInternetDate</apiname></xref> object
+[date string] from a desciptor which contains date. </p><codeblock xml:space="preserve">_LIT8(KTextDate, "Wed, 17 Jan 2006 06:36:30 GMT");
+TInternetDate internetDate1; 
+
+//set date time, "Wed, 17 Jan 2006 06:36:30 GMT"
+internetDate1.SetDateL(KTextDate); 
+
+//convert textDate to Date time format
+TDateTime time1 = internetDate1.DateTime(); 
+</codeblock><p>The code fragment sets the text form of date,
+"<codeph>Wed, 17 Jan 2006 06:36:30 GMT</codeph>" and converts it to DateTime
+format. </p></section>
+<section><title>See also</title> <p><xref href="GUID-795B41AF-FBEA-56CE-AE20-EF17BE754723.dita">HTTP
+Utilities Library Overview</xref>  </p> </section>
+</conbody></concept>
\ No newline at end of file