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