--- a/epoc32/include/tinternetdate.h Tue Nov 24 13:55:44 2009 +0000
+++ b/epoc32/include/tinternetdate.h Tue Mar 16 16:12:26 2010 +0000
@@ -1,1 +1,105 @@
-tinternetdate.h
+// Copyright (c) 2002-2009 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 "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
+// which accompanies this distribution, and is available
+// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+// This file contains the class TInternetDate
+//
+//
+
+
+
+/**
+ @file tinternetdate.h
+ @publishedAll
+ @released
+*/
+
+
+#ifndef __TINTERNETDATE_H__
+#define __TINTERNETDATE_H__
+
+#include <e32std.h>
+
+/**
+Stores dates in universal time and provides parsing of internet style dates
+into TDateTime and RFC 1123 (updates RFC 822) dates.
+
+Supports parsing of the following date formats:
+Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123
+Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036
+Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format
+
+In case of Date Formats with offsets "Mon, 21 Jan 2002 23:00:00 +0210" , equivalent
+time in UTC can be determined by substracting the offset from the local time (RFC 3339).
+
+All dates are store relative to Universal Time and not local time.
+
+@publishedAll
+@released
+@since 7.0
+*/
+class TInternetDate
+ {
+public:
+/**
+ Enum defining internet date formats.
+ @publishedAll
+ @released
+ @since 9.1
+ */
+ enum TInternetDateFormat
+ {
+ /**
+ Rfc 1123 Compliant date format
+ */
+ ERfc1123Format
+ };
+
+ inline TInternetDate();
+
+
+ inline TInternetDate(TDateTime aUniversalTime);
+
+ IMPORT_C void SetDateL(const TDesC8& aDate);
+
+ IMPORT_C const TDateTime& DateTime();
+
+ IMPORT_C HBufC8* InternetDateTimeL(TInternetDateFormat aInternetDateFormat);
+
+private:
+ /**
+ A date and time object
+ */
+ TDateTime iDateTime;
+ };
+
+
+/**
+ Intended Usage: Default Constructor. Used when setting dates that are in a text format using SetDateL
+
+ @since 7.0 .
+*/
+inline TInternetDate::TInternetDate()
+ {}
+
+/**
+ Intended Usage: Constructor. Used when setting a date that you later want parsed into an internet text format
+
+ @since 7.0
+ @param aUniversalTime a time that should correspond to Universal Time.
+*/
+inline TInternetDate::TInternetDate(TDateTime aUniversalTime) :
+ iDateTime(aUniversalTime)
+ {}
+
+
+#endif // __TINTERNETDATE_H__