// 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:

 //

 #ifndef __CALENDARCONVERTER_H__

 #define __CALENDARCONVERTER_H__

 #include <e32std.h>

 #include <e32base.h>

 class TChineseDate  

 /** Chinese date.

 Its public member data is the year cycle, the year (1-60), the month (1-12), whether or 

 not the month is a leap month, and the day in the month (1-29 or 30). 

 @publishedAll

 @released */

 	{

 public:

 	IMPORT_C TChineseDate();

 	IMPORT_C TBool operator==(const TChineseDate& aDate) const;

 public:

 	/** The year cycle. */

 	TInt iCycle;

 	/** The year (1-60). */

 	TInt iYear;

 	/** The month (1-12). */

 	TInt iMonth;

 	/** Whether or not the month is a leap month. */

 	TBool iLeapMonth;

 	/** The day in the month (1-29 or 30). */

 	TInt iDay;

 	};

 class CChineseCalendarConverter : public CBase

 /** Converts between TDateTime and TChineseDate formats in both directions. Chinese dates 

 are calculated using the -2636 epoch. This is equivalent to 2637 BCE (Before Common Era). 

 @publishedAll

 @released */

 	{

 public:

 	IMPORT_C static CChineseCalendarConverter* NewL();

 	/** Creates a Chinese date from a TDateTime value.

 	@param aDateTime The date/time value to convert.

 	@param aChineseDate On return, contains the Chinese date. If the supplied date 

 	is invalid, this contains KErrArgument. */

 	virtual void DateTimeToChineseL(const TDateTime& aDateTime, TChineseDate& aChineseDate)=0;

 	/** Creates a TDateTime value from a Chinese date.

 	@param aChineseDate A date in Chinese format.

 	@param aDateTime On return, contains a date value. If the supplied date is 

 	invalid, this contains KErrArgument. */

 	virtual void ChineseToDateTimeL(const TChineseDate& aChineseDate, TDateTime& aDateTime)=0;

 	/** Returns the range of dates, in standard date format, acceptable to the Chinese 

 	calendar converter. 

 	@param aLower On return, contains the lower limit of the converter.

 	@param aUpper On return, contains the upper limit of the converter. */

 	virtual void DateRange(TDateTime& aLower, TDateTime& aUpper)=0;

 	/** Returns the range of dates, in Chinese date format, acceptable to the Chinese 

 	calendar converter.

 	@param aLower On return, contains the lower limit of the converter.

 	@param aUpper On return, contains the upper limit of the converter. */

 	virtual void DateRange(TChineseDate& aLower, TChineseDate& aUpper)=0;

 	/** Returns the result of the last calendar conversion as a Julian date. 

 	@return The Julian date. */

 	virtual TReal JulianDate() __SOFTFP =0;

 	};

 #endif