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