icuSources/i18n/persncal.h

   1 // © 2016 and later: Unicode, Inc. and others.
   2 // License & terms of use: http://www.unicode.org/copyright.html
   3 /*
   4  ******************************************************************************
   5  * Copyright (C) 2003-2013, International Business Machines Corporation
   6  * and others. All Rights Reserved.
   7  ******************************************************************************
   8  *
   9  * File PERSNCAL.H
  10  *
  11  * Modification History:
  12  *
  13  *   Date        Name        Description
  14  *   9/23/2003 mehran        posted to icu-design
  15  *****************************************************************************
  16  */
  17
  18 #ifndef PERSNCAL_H
  19 #define PERSNCAL_H
  20
  21 #include "unicode/utypes.h"
  22
  23 #if !UCONFIG_NO_FORMATTING
  24
  25 #include "unicode/calendar.h"
  26
  27 U_NAMESPACE_BEGIN
  28
  29 /**
  30  * <code>PersianCalendar</code> is a subclass of <code>Calendar</code>
  31  * that implements the Persian calendar.  It is used as the official
  32  * calendar in Iran.  This calendar is also known as the "Hijri Shamsi"
  33  * calendar, since it starts at the time of Mohammed's emigration (or
  34  * "hijra") to Medinah on Thursday, July 15, 622 AD (Julian) and is a
  35  * solar calendar system (or "shamsi").
  36  * <p>
  37  * The Persian calendar is strictly solar, and thus a Persian year has twelve
  38  * solar months. A Persian year is about 365 days long, except in leap years
  39  * which is 366 days long.
  40  * <p>
  41  * The six first months of Persian Calendar are 31 days long. The next five
  42  * months are 30 days long. The last month is 29 days long in normal years,
  43  * and 30 days long in leap years.
  44  *
  45  * @see GregorianCalendar
  46  *
  47  * @author Mehran Mehr
  48  * @internal
  49  */
  50 class PersianCalendar : public Calendar {
  51  public:
  52   //-------------------------------------------------------------------------
  53   // Constants...
  54   //-------------------------------------------------------------------------
  55   /**
  56    * Constants for the months
  57    * @internal
  58    */
  59   enum EMonths {
  60     /**
  61      * Constant for Farvardin, the 1st month of the Persian year.
  62      * @internal
  63      */
  64     FARVARDIN = 0,
  65
  66     /**
  67      * Constant for Ordibehesht, the 2nd month of the Persian year.
  68      * @internal
  69      */
  70     ORDIBEHESHT = 1,
  71
  72     /**
  73      * Constant for Khordad, the 3rd month of the Persian year.
  74      * @internal
  75      */
  76     KHORDAD = 2,
  77
  78     /**
  79      * Constant for Tir, the 4th month of the Persian year.
  80      * @internal
  81      */
  82     TIR = 3,
  83
  84     /**
  85      * Constant for Mordad, the 5th month of the Persian year.
  86      * @internal
  87      */
  88     MORDAD = 4,
  89
  90     /**
  91      * Constant for Shahrivar, the 6th month of the Persian year.
  92      * @internal
  93      */
  94     SHAHRIVAR = 5,
  95
  96     /**
  97      * Constant for Mehr, the 7th month of the Persian year.
  98      * @internal
  99      */
 100     MEHR = 6,
 101
 102     /**
 103      * Constant for Aban, the 8th month of the Persian year.
 104      * @internal
 105      */
 106     ABAN = 7,
 107
 108     /**
 109      * Constant for Azar, the 9th month of the Persian year.
 110      * @internal
 111      */
 112     AZAR = 8,
 113
 114     /**
 115      * Constant for Dei, the 10th month of the Persian year.
 116      * @internal
 117      */
 118     DEI = 9,
 119
 120     /**
 121      * Constant for Bahman, the 11th month of the Persian year.
 122      * @internal
 123      */
 124     BAHMAN = 10,
 125
 126     /**
 127      * Constant for Esfand, the 12th month of the Persian year.
 128      * @internal
 129      */
 130     ESFAND = 11,
 131
 132     PERSIAN_MONTH_MAX
 133   };
 134
 135
 136
 137   //-------------------------------------------------------------------------
 138   // Constructors...
 139   //-------------------------------------------------------------------------
 140
 141   /**
 142    * Constructs a PersianCalendar based on the current time in the default time zone
 143    * with the given locale.
 144    *
 145    * @param aLocale  The given locale.
 146    * @param success  Indicates the status of PersianCalendar object construction.
 147    *                 Returns U_ZERO_ERROR if constructed successfully.
 148    * @internal
 149    */
 150   PersianCalendar(const Locale& aLocale, UErrorCode &success);
 151
 152   /**
 153    * Copy Constructor
 154    * @internal
 155    */
 156   PersianCalendar(const PersianCalendar& other);
 157
 158   /**
 159    * Destructor.
 160    * @internal
 161    */
 162   virtual ~PersianCalendar();
 163
 164   // TODO: copy c'tor, etc
 165
 166   // clone
 167   virtual Calendar* clone() const;
 168
 169  private:
 170   /**
 171    * Determine whether a year is a leap year in the Persian calendar
 172    */
 173   static UBool isLeapYear(int32_t year);
 174
 175   /**
 176    * Return the day # on which the given year starts.  Days are counted
 177    * from the Hijri epoch, origin 0.
 178    */
 179   int32_t yearStart(int32_t year);
 180
 181   /**
 182    * Return the day # on which the given month starts.  Days are counted
 183    * from the Hijri epoch, origin 0.
 184    *
 185    * @param year  The hijri shamsi year
 186    * @param year  The hijri shamsi month, 0-based
 187    */
 188   int32_t monthStart(int32_t year, int32_t month) const;
 189
 190   //----------------------------------------------------------------------
 191   // Calendar framework
 192   //----------------------------------------------------------------------
 193  protected:
 194   /**
 195    * @internal
 196    */
 197   virtual int32_t handleGetLimit(UCalendarDateFields field, ELimitType limitType) const;
 198
 199   /**
 200    * Return the length (in days) of the given month.
 201    *
 202    * @param year  The hijri shamsi year
 203    * @param year  The hijri shamsi month, 0-based
 204    * @internal
 205    */
 206   virtual int32_t handleGetMonthLength(int32_t extendedYear, int32_t month) const;
 207
 208   /**
 209    * Return the number of days in the given Persian year
 210    * @internal
 211    */
 212   virtual int32_t handleGetYearLength(int32_t extendedYear) const;
 213
 214   //-------------------------------------------------------------------------
 215   // Functions for converting from field values to milliseconds....
 216   //-------------------------------------------------------------------------
 217
 218   // Return JD of start of given month/year
 219   /**
 220    * @internal
 221    */
 222   virtual int32_t handleComputeMonthStart(int32_t eyear, int32_t month, UBool useMonth) const;
 223
 224   //-------------------------------------------------------------------------
 225   // Functions for converting from milliseconds to field values
 226   //-------------------------------------------------------------------------
 227
 228   /**
 229    * @internal
 230    */
 231   virtual int32_t handleGetExtendedYear();
 232
 233   /**
 234    * Override Calendar to compute several fields specific to the Persian
 235    * calendar system.  These are:
 236    *
 237    * <ul><li>ERA
 238    * <li>YEAR
 239    * <li>MONTH
 240    * <li>DAY_OF_MONTH
 241    * <li>DAY_OF_YEAR
 242    * <li>EXTENDED_YEAR</ul>
 243    *
 244    * The DAY_OF_WEEK and DOW_LOCAL fields are already set when this
 245    * method is called. The getGregorianXxx() methods return Gregorian
 246    * calendar equivalents for the given Julian day.
 247    * @internal
 248    */
 249   virtual void handleComputeFields(int32_t julianDay, UErrorCode &status);
 250
 251   // UObject stuff
 252  public:
 253   /**
 254    * @return   The class ID for this object. All objects of a given class have the
 255    *           same class ID. Objects of other classes have different class IDs.
 256    * @internal
 257    */
 258   virtual UClassID getDynamicClassID(void) const;
 259
 260   /**
 261    * Return the class ID for this class. This is useful only for comparing to a return
 262    * value from getDynamicClassID(). For example:
 263    *
 264    *      Base* polymorphic_pointer = createPolymorphicObject();
 265    *      if (polymorphic_pointer->getDynamicClassID() ==
 266    *          Derived::getStaticClassID()) ...
 267    *
 268    * @return   The class ID for all objects of this class.
 269    * @internal
 270    */
 271   U_I18N_API static UClassID U_EXPORT2 getStaticClassID(void);
 272
 273   /**
 274    * return the calendar type, "persian".
 275    *
 276    * @return calendar type
 277    * @internal
 278    */
 279   virtual const char * getType() const;
 280
 281  private:
 282   PersianCalendar(); // default constructor not implemented
 283
 284  protected:
 285
 286   /**
 287    * (Overrides Calendar) Return true if the current date for this Calendar is in
 288    * Daylight Savings Time. Recognizes DST_OFFSET, if it is set.
 289    *
 290    * @param status Fill-in parameter which receives the status of this operation.
 291    * @return   True if the current date for this Calendar is in Daylight Savings Time,
 292    *           false, otherwise.
 293    * @internal
 294    */
 295   virtual UBool inDaylightTime(UErrorCode& status) const;
 296
 297   /**
 298    * Returns TRUE because the Persian Calendar does have a default century
 299    * @internal
 300    */
 301   virtual UBool haveDefaultCentury() const;
 302
 303   /**
 304    * Returns the date of the start of the default century
 305    * @return start of century - in milliseconds since epoch, 1970
 306    * @internal
 307    */
 308   virtual UDate defaultCenturyStart() const;
 309
 310   /**
 311    * Returns the year in which the default century begins
 312    * @internal
 313    */
 314   virtual int32_t defaultCenturyStartYear() const;
 315 };
 316
 317 U_NAMESPACE_END
 318
 319 #endif
 320 #endif
 321
 322
 323