sl@0: // Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: // This file contains the class TInternetDate
sl@0: // 
sl@0: //
sl@0: 
sl@0: /**
sl@0:  @file tinternetdate.h
sl@0:  @publishedAll
sl@0:  @released
sl@0: */
sl@0:   
sl@0: 
sl@0: #ifndef		__TINTERNETDATE_H__
sl@0: #define		__TINTERNETDATE_H__
sl@0: 
sl@0: #include <e32std.h>
sl@0: 
sl@0: /**
sl@0: Stores dates in universal time and provides parsing of internet style dates 
sl@0: into TDateTime and RFC 1123 (updates RFC 822) dates.
sl@0: 
sl@0: Supports parsing of the following date formats:
sl@0: Sun, 06 Nov 1994 08:49:37 GMT  ; RFC 822, updated by RFC 1123
sl@0: Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036
sl@0: Sun Nov  6 08:49:37 1994       ; ANSI C's asctime() format
sl@0: 
sl@0: In case of Date Formats with offsets "Mon, 21 Jan 2002 23:00:00 +0210" , equivalent 
sl@0: time in UTC can be determined by substracting the offset from the local time (RFC 3339).
sl@0: 
sl@0: All dates are store relative to Universal Time and not local time. 
sl@0: 
sl@0: @publishedAll
sl@0: @released
sl@0: @since 7.0
sl@0: */
sl@0: class TInternetDate
sl@0: 	{
sl@0: public:	
sl@0: /** 
sl@0: 	Enum defining internet date formats.
sl@0: 	@publishedAll
sl@0: 	@released
sl@0: 	@since 9.1	
sl@0:  */
sl@0: 	enum TInternetDateFormat
sl@0: 		{
sl@0: 		/** 
sl@0: 			Rfc 1123 Compliant date format 
sl@0: 		*/
sl@0: 		ERfc1123Format
sl@0: 		};
sl@0: 
sl@0: 	inline TInternetDate();
sl@0: 
sl@0: 
sl@0: 	inline TInternetDate(TDateTime aUniversalTime);
sl@0: 
sl@0: 	IMPORT_C void SetDateL(const TDesC8& aDate);
sl@0: 
sl@0: 	IMPORT_C const TDateTime& DateTime();
sl@0: 
sl@0: 	IMPORT_C HBufC8* InternetDateTimeL(TInternetDateFormat aInternetDateFormat);
sl@0: 
sl@0: private:
sl@0: 	/**
sl@0: 	A date and time object
sl@0: 	*/
sl@0: 	TDateTime iDateTime;
sl@0: 	};
sl@0: 
sl@0: 
sl@0: /**
sl@0: 	Intended Usage:	Default Constructor. Used when setting dates that are in a text format using SetDateL
sl@0: 	
sl@0: 	@since			7.0	.	
sl@0: */
sl@0: inline TInternetDate::TInternetDate()
sl@0: 	{}
sl@0: 
sl@0: /**
sl@0: 	Intended Usage:	Constructor. Used when setting a date that you later want parsed into an internet text format
sl@0: 	
sl@0: 	@since			7.0
sl@0: 	@param			aUniversalTime	a time that should correspond to Universal Time.
sl@0: */
sl@0: inline TInternetDate::TInternetDate(TDateTime aUniversalTime) :
sl@0: 	iDateTime(aUniversalTime)
sl@0: 	{}
sl@0: 
sl@0: 
sl@0: #endif	//	__TINTERNETDATE_H__