1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/os/ossrv/genericservices/httputils/inc/tinternetdate.h	Fri Jun 15 03:10:57 2012 +0200
     1.3 @@ -0,0 +1,103 @@
     1.4 +// Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies).
     1.5 +// All rights reserved.
     1.6 +// This component and the accompanying materials are made available
     1.7 +// under the terms of "Eclipse Public License v1.0"
     1.8 +// which accompanies this distribution, and is available
     1.9 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
    1.10 +//
    1.11 +// Initial Contributors:
    1.12 +// Nokia Corporation - initial contribution.
    1.13 +//
    1.14 +// Contributors:
    1.15 +//
    1.16 +// Description:
    1.17 +// This file contains the class TInternetDate
    1.18 +// 
    1.19 +//
    1.20 +
    1.21 +/**
    1.22 + @file tinternetdate.h
    1.23 + @publishedAll
    1.24 + @released
    1.25 +*/
    1.26 +  
    1.27 +
    1.28 +#ifndef		__TINTERNETDATE_H__
    1.29 +#define		__TINTERNETDATE_H__
    1.30 +
    1.31 +#include <e32std.h>
    1.32 +
    1.33 +/**
    1.34 +Stores dates in universal time and provides parsing of internet style dates 
    1.35 +into TDateTime and RFC 1123 (updates RFC 822) dates.
    1.36 +
    1.37 +Supports parsing of the following date formats:
    1.38 +Sun, 06 Nov 1994 08:49:37 GMT  ; RFC 822, updated by RFC 1123
    1.39 +Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036
    1.40 +Sun Nov  6 08:49:37 1994       ; ANSI C's asctime() format
    1.41 +
    1.42 +In case of Date Formats with offsets "Mon, 21 Jan 2002 23:00:00 +0210" , equivalent 
    1.43 +time in UTC can be determined by substracting the offset from the local time (RFC 3339).
    1.44 +
    1.45 +All dates are store relative to Universal Time and not local time. 
    1.46 +
    1.47 +@publishedAll
    1.48 +@released
    1.49 +@since 7.0
    1.50 +*/
    1.51 +class TInternetDate
    1.52 +	{
    1.53 +public:	
    1.54 +/** 
    1.55 +	Enum defining internet date formats.
    1.56 +	@publishedAll
    1.57 +	@released
    1.58 +	@since 9.1	
    1.59 + */
    1.60 +	enum TInternetDateFormat
    1.61 +		{
    1.62 +		/** 
    1.63 +			Rfc 1123 Compliant date format 
    1.64 +		*/
    1.65 +		ERfc1123Format
    1.66 +		};
    1.67 +
    1.68 +	inline TInternetDate();
    1.69 +
    1.70 +
    1.71 +	inline TInternetDate(TDateTime aUniversalTime);
    1.72 +
    1.73 +	IMPORT_C void SetDateL(const TDesC8& aDate);
    1.74 +
    1.75 +	IMPORT_C const TDateTime& DateTime();
    1.76 +
    1.77 +	IMPORT_C HBufC8* InternetDateTimeL(TInternetDateFormat aInternetDateFormat);
    1.78 +
    1.79 +private:
    1.80 +	/**
    1.81 +	A date and time object
    1.82 +	*/
    1.83 +	TDateTime iDateTime;
    1.84 +	};
    1.85 +
    1.86 +
    1.87 +/**
    1.88 +	Intended Usage:	Default Constructor. Used when setting dates that are in a text format using SetDateL
    1.89 +	
    1.90 +	@since			7.0	.	
    1.91 +*/
    1.92 +inline TInternetDate::TInternetDate()
    1.93 +	{}
    1.94 +
    1.95 +/**
    1.96 +	Intended Usage:	Constructor. Used when setting a date that you later want parsed into an internet text format
    1.97 +	
    1.98 +	@since			7.0
    1.99 +	@param			aUniversalTime	a time that should correspond to Universal Time.
   1.100 +*/
   1.101 +inline TInternetDate::TInternetDate(TDateTime aUniversalTime) :
   1.102 +	iDateTime(aUniversalTime)
   1.103 +	{}
   1.104 +
   1.105 +
   1.106 +#endif	//	__TINTERNETDATE_H__