// Copyright (c) 2005-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:
//

#ifndef __CALTIME_H__
#define __CALTIME_H__

#include <e32base.h>

/** Represents a date/time, as used in the Calendar API.

This stores a single TTime, which may be set in UTC or local or floating local 
time, and can be retrieved in either UTC or system local time.

There are references to null time throughout the Interim API - this means Time::NullTTime().

@publishedAll
@released
*/
NONSHARABLE_CLASS(TCalTime)
	{
public:

	/** The time mode for a calendar time
	@publishedAll
	@released
	*/
	enum TTimeMode
		{
		/** Floating time. */
		EFloating,
		/** Fixed time in UTC format. */
		EFixedUtc,
		/** Fixed time in local time with time zone reference format. */
		EFixedTimeZone
		};

public:
	IMPORT_C TCalTime();
	
	IMPORT_C void SetTimeLocalFloatingL(const TTime& aLocalTime);
	IMPORT_C void SetTimeUtcL(const TTime& aUtcTime);
	IMPORT_C void SetTimeLocalL(const TTime& aLocalTime);
	IMPORT_C TTimeMode TimeMode() const; 
	IMPORT_C TTime TimeUtcL() const;
	IMPORT_C TTime TimeLocalL() const;
	
	IMPORT_C static TTime MaxTime();
	IMPORT_C static TTime MinTime();
private:
	TTime	iTime;
	TUint8	iTimeMode;  
	TInt8	iReserved1;
	TInt16 	iReserved2;
	};
	
#endif // __CALTIME_H__