375 lines
11 KiB
C++
375 lines
11 KiB
C++
// © 2016 and later: Unicode, Inc. and others.
|
|
// License & terms of use: http://www.unicode.org/copyright.html
|
|
/*
|
|
*****************************************************************************
|
|
* Copyright (C) 2003-2008, International Business Machines Corporation
|
|
* and others. All Rights Reserved.
|
|
*****************************************************************************
|
|
*
|
|
* File INDIANCAL.H
|
|
*****************************************************************************
|
|
*/
|
|
|
|
#ifndef INDIANCAL_H
|
|
#define INDIANCAL_H
|
|
|
|
#include "unicode/utypes.h"
|
|
|
|
#if !UCONFIG_NO_FORMATTING
|
|
|
|
#include "unicode/calendar.h"
|
|
|
|
U_NAMESPACE_BEGIN
|
|
|
|
/**
|
|
* Concrete class which provides the Indian calendar.
|
|
* <P>
|
|
* <code>IndianCalendar</code> is a subclass of <code>Calendar</code>
|
|
* that numbers years since the begining of SAKA ERA. This is the civil calendar
|
|
* which is accepted by government of India as Indian National Calendar.
|
|
* The two calendars most widely used in India today are the Vikrama calendar
|
|
* followed in North India and the Shalivahana or Saka calendar which is followed
|
|
* in South India and Maharashtra.
|
|
|
|
* A variant of the Shalivahana Calendar was reformed and standardized as the
|
|
* Indian National calendar in 1957.
|
|
* <p>
|
|
* Some details of Indian National Calendar (to be implemented) :
|
|
* The Months
|
|
* Month Length Start date (Gregorian)
|
|
* =================================================
|
|
* 1 Chaitra 30/31 March 22*
|
|
* 2 Vaisakha 31 April 21
|
|
* 3 Jyaistha 31 May 22
|
|
* 4 Asadha 31 June 22
|
|
* 5 Sravana 31 July 23
|
|
* 6 Bhadra 31 August 23
|
|
* 7 Asvina 30 September 23
|
|
* 8 Kartika 30 October 23
|
|
* 9 Agrahayana 30 November 22
|
|
* 10 Pausa 30 December 22
|
|
* 11 Magha 30 January 21
|
|
* 12 Phalguna 30 February 20
|
|
|
|
* In leap years, Chaitra has 31 days and starts on March 21 instead.
|
|
* The leap years of Gregorian calendar and Indian National Calendar are in synchornization.
|
|
* So When its a leap year in Gregorian calendar then Chaitra has 31 days.
|
|
*
|
|
* The Years
|
|
* Years are counted in the Saka Era, which starts its year 0 in 78AD (by gregorian calendar).
|
|
* So for eg. 9th June 2006 by Gregorian Calendar, is same as 19th of Jyaistha in 1928 of Saka
|
|
* era by Indian National Calendar.
|
|
* <p>
|
|
* The Indian Calendar has only one allowable era: <code>Saka Era</code>. If the
|
|
* calendar is not in lenient mode (see <code>setLenient</code>), dates before
|
|
* 1/1/1 Saka Era are rejected with an <code>IllegalArgumentException</code>.
|
|
* <p>
|
|
* @internal
|
|
*/
|
|
|
|
|
|
class IndianCalendar : public Calendar {
|
|
public:
|
|
/**
|
|
* Useful constants for IndianCalendar.
|
|
* @internal
|
|
*/
|
|
enum EEras {
|
|
/**
|
|
* Constant for Chaitra, the 1st month of the Indian year.
|
|
*/
|
|
CHAITRA,
|
|
|
|
/**
|
|
* Constant for Vaisakha, the 2nd month of the Indian year.
|
|
*/
|
|
VAISAKHA,
|
|
|
|
/**
|
|
* Constant for Jyaistha, the 3rd month of the Indian year.
|
|
*/
|
|
JYAISTHA,
|
|
|
|
/**
|
|
* Constant for Asadha, the 4th month of the Indian year.
|
|
*/
|
|
ASADHA,
|
|
|
|
/**
|
|
* Constant for Sravana, the 5th month of the Indian year.
|
|
*/
|
|
SRAVANA,
|
|
|
|
/**
|
|
* Constant for Bhadra the 6th month of the Indian year
|
|
*/
|
|
BHADRA,
|
|
|
|
/**
|
|
* Constant for the Asvina, the 7th month of the Indian year.
|
|
*/
|
|
ASVINA,
|
|
|
|
/**
|
|
* Constant for Kartika, the 8th month of the Indian year.
|
|
*/
|
|
KARTIKA,
|
|
|
|
/**
|
|
* Constant for Agrahayana, the 9th month of the Indian year.
|
|
*/
|
|
AGRAHAYANA,
|
|
|
|
/**
|
|
* Constant for Pausa, the 10th month of the Indian year.
|
|
*/
|
|
PAUSA,
|
|
|
|
/**
|
|
* Constant for Magha, the 11th month of the Indian year.
|
|
*/
|
|
MAGHA,
|
|
|
|
/**
|
|
* Constant for Phalguna, the 12th month of the Indian year.
|
|
*/
|
|
PHALGUNA
|
|
};
|
|
|
|
//-------------------------------------------------------------------------
|
|
// Constructors...
|
|
//-------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Constructs an IndianCalendar based on the current time in the default time zone
|
|
* with the given locale.
|
|
*
|
|
* @param aLocale The given locale.
|
|
* @param success Indicates the status of IndianCalendar object construction.
|
|
* Returns U_ZERO_ERROR if constructed successfully.
|
|
* @param beCivil Whether the calendar should be civil (default-TRUE) or religious (FALSE)
|
|
* @internal
|
|
*/
|
|
IndianCalendar(const Locale& aLocale, UErrorCode &success);
|
|
|
|
/**
|
|
* Copy Constructor
|
|
* @internal
|
|
*/
|
|
IndianCalendar(const IndianCalendar& other);
|
|
|
|
/**
|
|
* Destructor.
|
|
* @internal
|
|
*/
|
|
virtual ~IndianCalendar();
|
|
|
|
/**
|
|
* Determines whether this object uses the fixed-cycle Indian civil calendar
|
|
* or an approximation of the religious, astronomical calendar.
|
|
*
|
|
* @param beCivil <code>CIVIL</code> to use the civil calendar,
|
|
* <code>ASTRONOMICAL</code> to use the astronomical calendar.
|
|
* @internal
|
|
*/
|
|
//void setCivil(ECivil beCivil, UErrorCode &status);
|
|
|
|
/**
|
|
* Returns <code>true</code> if this object is using the fixed-cycle civil
|
|
* calendar, or <code>false</code> if using the religious, astronomical
|
|
* calendar.
|
|
* @internal
|
|
*/
|
|
//UBool isCivil();
|
|
|
|
|
|
// TODO: copy c'tor, etc
|
|
|
|
// clone
|
|
virtual Calendar* clone() const;
|
|
|
|
private:
|
|
/**
|
|
* Determine whether a year is the gregorian year a leap year
|
|
*/
|
|
//static UBool isGregorianLeap(int32_t year);
|
|
//----------------------------------------------------------------------
|
|
// Calendar framework
|
|
//----------------------------------------------------------------------
|
|
protected:
|
|
/**
|
|
* @internal
|
|
*/
|
|
virtual int32_t handleGetLimit(UCalendarDateFields field, ELimitType limitType) const;
|
|
|
|
/**
|
|
* Return the length (in days) of the given month.
|
|
*
|
|
* @param year The year in Saka era
|
|
* @param year The month(0-based) in Indian year
|
|
* @internal
|
|
*/
|
|
virtual int32_t handleGetMonthLength(int32_t extendedYear, int32_t month) const;
|
|
|
|
/**
|
|
* Return the number of days in the given Indian year
|
|
* @internal
|
|
*/
|
|
virtual int32_t handleGetYearLength(int32_t extendedYear) const;
|
|
|
|
//-------------------------------------------------------------------------
|
|
// Functions for converting from field values to milliseconds....
|
|
//-------------------------------------------------------------------------
|
|
|
|
// Return JD of start of given month/year
|
|
/**
|
|
* @internal
|
|
*/
|
|
virtual int32_t handleComputeMonthStart(int32_t eyear, int32_t month, UBool useMonth) const;
|
|
|
|
//-------------------------------------------------------------------------
|
|
// Functions for converting from milliseconds to field values
|
|
//-------------------------------------------------------------------------
|
|
|
|
/**
|
|
* @internal
|
|
*/
|
|
virtual int32_t handleGetExtendedYear();
|
|
|
|
/**
|
|
* Override Calendar to compute several fields specific to the Indian
|
|
* calendar system. These are:
|
|
*
|
|
* <ul><li>ERA
|
|
* <li>YEAR
|
|
* <li>MONTH
|
|
* <li>DAY_OF_MONTH
|
|
* <li>DAY_OF_YEAR
|
|
* <li>EXTENDED_YEAR</ul>
|
|
*
|
|
* The DAY_OF_WEEK and DOW_LOCAL fields are already set when this
|
|
* method is called. The getGregorianXxx() methods return Gregorian
|
|
* calendar equivalents for the given Julian day.
|
|
* @internal
|
|
*/
|
|
virtual void handleComputeFields(int32_t julianDay, UErrorCode &status);
|
|
|
|
// UObject stuff
|
|
public:
|
|
/**
|
|
* @return The class ID for this object. All objects of a given class have the
|
|
* same class ID. Objects of other classes have different class IDs.
|
|
* @internal
|
|
*/
|
|
virtual UClassID getDynamicClassID(void) const;
|
|
|
|
/**
|
|
* Return the class ID for this class. This is useful only for comparing to a return
|
|
* value from getDynamicClassID(). For example:
|
|
*
|
|
* Base* polymorphic_pointer = createPolymorphicObject();
|
|
* if (polymorphic_pointer->getDynamicClassID() ==
|
|
* Derived::getStaticClassID()) ...
|
|
*
|
|
* @return The class ID for all objects of this class.
|
|
* @internal
|
|
*/
|
|
U_I18N_API static UClassID U_EXPORT2 getStaticClassID(void);
|
|
|
|
/**
|
|
* return the calendar type, "buddhist".
|
|
*
|
|
* @return calendar type
|
|
* @internal
|
|
*/
|
|
virtual const char * getType() const;
|
|
|
|
private:
|
|
IndianCalendar(); // default constructor not implemented
|
|
|
|
// Default century.
|
|
protected:
|
|
|
|
/**
|
|
* (Overrides Calendar) Return true if the current date for this Calendar is in
|
|
* Daylight Savings Time. Recognizes DST_OFFSET, if it is set.
|
|
*
|
|
* @param status Fill-in parameter which receives the status of this operation.
|
|
* @return True if the current date for this Calendar is in Daylight Savings Time,
|
|
* false, otherwise.
|
|
* @internal
|
|
*/
|
|
virtual UBool inDaylightTime(UErrorCode& status) const;
|
|
|
|
|
|
/**
|
|
* Returns TRUE because the Indian Calendar does have a default century
|
|
* @internal
|
|
*/
|
|
virtual UBool haveDefaultCentury() const;
|
|
|
|
/**
|
|
* Returns the date of the start of the default century
|
|
* @return start of century - in milliseconds since epoch, 1970
|
|
* @internal
|
|
*/
|
|
virtual UDate defaultCenturyStart() const;
|
|
|
|
/**
|
|
* Returns the year in which the default century begins
|
|
* @internal
|
|
*/
|
|
virtual int32_t defaultCenturyStartYear() const;
|
|
|
|
private: // default century stuff.
|
|
/**
|
|
* The system maintains a static default century start date. This is initialized
|
|
* the first time it is used. Before then, it is set to SYSTEM_DEFAULT_CENTURY to
|
|
* indicate an uninitialized state. Once the system default century date and year
|
|
* are set, they do not change.
|
|
*/
|
|
static UDate fgSystemDefaultCenturyStart;
|
|
|
|
/**
|
|
* See documentation for systemDefaultCenturyStart.
|
|
*/
|
|
static int32_t fgSystemDefaultCenturyStartYear;
|
|
|
|
/**
|
|
* Default value that indicates the defaultCenturyStartYear is unitialized
|
|
*/
|
|
static const int32_t fgSystemDefaultCenturyYear;
|
|
|
|
/**
|
|
* start of default century, as a date
|
|
*/
|
|
static const UDate fgSystemDefaultCentury;
|
|
|
|
/**
|
|
* Returns the beginning date of the 100-year window that dates
|
|
* with 2-digit years are considered to fall within.
|
|
*/
|
|
UDate internalGetDefaultCenturyStart(void) const;
|
|
|
|
/**
|
|
* Returns the first year of the 100-year window that dates with
|
|
* 2-digit years are considered to fall within.
|
|
*/
|
|
int32_t internalGetDefaultCenturyStartYear(void) const;
|
|
|
|
/**
|
|
* Initializes the 100-year window that dates with 2-digit years
|
|
* are considered to fall within so that its start date is 80 years
|
|
* before the current time.
|
|
*/
|
|
static void initializeSystemDefaultCentury(void);
|
|
};
|
|
|
|
U_NAMESPACE_END
|
|
|
|
#endif
|
|
#endif
|
|
|
|
|
|
|