/** * The absolute date, in milliseconds since 1/1/1970 AD, Gregorian, * of the start of the Hebrew calendar. In order to keep this calendar's * time of day in sync with that of the Gregorian calendar, we use * midnight, rather than sunset the day before.
*/ //static const double EPOCH_MILLIS = -180799862400000.; // 1/1/1 HY
/** * The lengths of the Hebrew months. This is complicated, because there * are three different types of years, or six if you count leap years. * Due to the rules for postponing the start of the year to avoid having * certain holidays fall on the sabbath, the year can end up being three * different lengths, called "deficient", "normal", and "complete".
*/ staticconst int8_t MONTH_LENGTH[][3] = { // Deficient Normal Complete
{ 30, 30, 30 }, //Tishri
{ 29, 29, 30 }, //Heshvan
{ 29, 30, 30 }, //Kislev
{ 29, 29, 29 }, //Tevet
{ 30, 30, 30 }, //Shevat
{ 30, 30, 30 }, //Adar I (leap years only)
{ 29, 29, 29 }, //Adar
{ 30, 30, 30 }, //Nisan
{ 29, 29, 29 }, //Iyar
{ 30, 30, 30 }, //Sivan
{ 29, 29, 29 }, //Tammuz
{ 30, 30, 30 }, //Av
{ 29, 29, 29 }, //Elul
};
/** * The cumulative # of days to the end of each month in a non-leap year * Although this can be calculated from the MONTH_LENGTH table, * keeping it around separately makes some calculations a lot faster
*/
/** * Constructs a default <code>HebrewCalendar</code> using the current time * in the default time zone with the default locale. * @internal
*/
HebrewCalendar::HebrewCalendar(const Locale& aLocale, UErrorCode& success)
: Calendar(TimeZone::forLocaleOrDefault(aLocale), aLocale, success)
{
setTimeInMillis(getNow(), success); // Call this again now that the vtable is set up properly.
}
//------------------------------------------------------------------------- // Rolling and adding functions overridden from Calendar // // These methods call through to the default implementation in IBMCalendar // for most of the fields and only handle the unusual ones themselves. //-------------------------------------------------------------------------
/** * Add a signed amount to a specified field, using this calendar's rules. * For example, to add three days to the current date, you can call * <code>add(Calendar.DATE, 3)</code>. * <p> * When adding to certain fields, the values of other fields may conflict and * need to be changed. For example, when adding one to the {@link #MONTH MONTH} field * for the date "30 Av 5758", the {@link #DAY_OF_MONTH DAY_OF_MONTH} field * must be adjusted so that the result is "29 Elul 5758" rather than the invalid * "30 Elul 5758". * <p> * This method is able to add to * all fields except for {@link #ERA ERA}, {@link #DST_OFFSET DST_OFFSET}, * and {@link #ZONE_OFFSET ZONE_OFFSET}. * <p> * <b>Note:</b> You should always use {@link #roll roll} and add rather * than attempting to perform arithmetic operations directly on the fields * of a <tt>HebrewCalendar</tt>. Since the {@link #MONTH MONTH} field behaves * discontinuously in non-leap years, simple arithmetic can give invalid results. * <p> * @param field the time field. * @param amount the amount to add to the field. * * @exception IllegalArgumentException if the field is invalid or refers * to a field that cannot be handled by this method. * @internal
*/ void HebrewCalendar::add(UCalendarDateFields field, int32_t amount, UErrorCode& status)
{ if(U_FAILURE(status)) { return;
} switch (field) { case UCAL_MONTH: case UCAL_ORDINAL_MONTH:
{ // We can't just do a set(MONTH, get(MONTH) + amount). The // reason is ADAR_1. Suppose amount is +2 and we land in // ADAR_1 -- then we have to bump to ADAR_2 aka ADAR. But // if amount is -2 and we land in ADAR_1, then we have to // bump the other way -- down to SHEVAT. - Alan 11/00
int64_t month = get(UCAL_MONTH, status);
int32_t year = get(UCAL_YEAR, status);
UBool acrossAdar1; if (amount > 0) {
acrossAdar1 = (month < ADAR_1); // started before ADAR_1?
month += amount; // We know there are total 235 months in every 19 years. To speed // up the iteration, we first fast forward in the multiple of 235 // months for 19 years before the iteration which check the leap year. if (month >= MONTHS_IN_CYCLE) { if (uprv_add32_overflow(year, (month / MONTHS_IN_CYCLE) * YEARS_IN_CYCLE, &year)) {
status = U_ILLEGAL_ARGUMENT_ERROR; return;
}
month %= MONTHS_IN_CYCLE;
}
for (;;) { if (acrossAdar1 && month>=ADAR_1 && !isLeapYear(year)) {
++month;
} if (month <= ELUL) { break;
}
month -= ELUL+1;
++year;
acrossAdar1 = true;
}
} else {
acrossAdar1 = (month > ADAR_1); // started after ADAR_1?
month += amount; // We know there are total 235 months in every 19 years. To speed // up the iteration, we first fast forward in the multiple of 235 // months for 19 years before the iteration which check the leap year. if (month <= -MONTHS_IN_CYCLE) { if (uprv_add32_overflow(year, (month / MONTHS_IN_CYCLE) * YEARS_IN_CYCLE, &year)) {
status = U_ILLEGAL_ARGUMENT_ERROR; return;
}
month %= MONTHS_IN_CYCLE;
} for (;;) { if (acrossAdar1 && month<=ADAR_1 && !isLeapYear(year)) {
--month;
} if (month >= 0) { break;
}
month += ELUL+1;
--year;
acrossAdar1 = true;
}
}
set(UCAL_MONTH, month);
set(UCAL_YEAR, year);
pinField(UCAL_DAY_OF_MONTH, status); break;
}
/** * Rolls (up/down) a specified amount time on the given field. For * example, to roll the current date up by three days, you can call * <code>roll(Calendar.DATE, 3)</code>. If the * field is rolled past its maximum allowable value, it will "wrap" back * to its minimum and continue rolling. * For example, calling <code>roll(Calendar.DATE, 10)</code> * on a Hebrew calendar set to "25 Av 5758" will result in the date "5 Av 5758". * <p> * When rolling certain fields, the values of other fields may conflict and * need to be changed. For example, when rolling the {@link #MONTH MONTH} field * upward by one for the date "30 Av 5758", the {@link #DAY_OF_MONTH DAY_OF_MONTH} field * must be adjusted so that the result is "29 Elul 5758" rather than the invalid * "30 Elul". * <p> * This method is able to roll * all fields except for {@link #ERA ERA}, {@link #DST_OFFSET DST_OFFSET}, * and {@link #ZONE_OFFSET ZONE_OFFSET}. Subclasses may, of course, add support for * additional fields in their overrides of <code>roll</code>. * <p> * <b>Note:</b> You should always use roll and {@link #add add} rather * than attempting to perform arithmetic operations directly on the fields * of a <tt>HebrewCalendar</tt>. Since the {@link #MONTH MONTH} field behaves * discontinuously in non-leap years, simple arithmetic can give invalid results. * <p> * @param field the time field. * @param amount the amount by which the field should be rolled. * * @exception IllegalArgumentException if the field is invalid or refers * to a field that cannot be handled by this method. * @internal
*/ void HebrewCalendar::roll(UCalendarDateFields field, int32_t amount, UErrorCode& status)
{ if(U_FAILURE(status)) { return;
} switch (field) { case UCAL_MONTH: case UCAL_ORDINAL_MONTH:
{
int32_t month = get(UCAL_MONTH, status);
int32_t year = get(UCAL_YEAR, status);
UBool leapYear = isLeapYear(year);
int32_t yearLength = monthsInYear(year);
int32_t newMonth = month + (amount % yearLength); // // If it's not a leap year and we're rolling past the missing month // of ADAR_1, we need to roll an extra month to make up for it. // if (!leapYear) { if (amount > 0 && month < ADAR_1 && newMonth >= ADAR_1) {
newMonth++;
} elseif (amount < 0 && month > ADAR_1 && newMonth <= ADAR_1) {
newMonth--;
}
}
set(UCAL_MONTH, (newMonth + 13) % 13);
pinField(UCAL_DAY_OF_MONTH, status); return;
} default:
Calendar::roll(field, amount, status);
}
}
//------------------------------------------------------------------------- // Support methods //-------------------------------------------------------------------------
// Hebrew date calculations are performed in terms of days, hours, and // "parts" (or halakim), which are 1/1080 of an hour, or 3 1/3 seconds. staticconst int32_t HOUR_PARTS = 1080; staticconst int32_t DAY_PARTS = 24*HOUR_PARTS;
// An approximate value for the length of a lunar month. // It is used to calculate the approximate year and month of a given // absolute date. staticconst int32_t MONTH_DAYS = 29; staticconst int32_t MONTH_FRACT = 12*HOUR_PARTS + 793; staticconst int32_t MONTH_PARTS = MONTH_DAYS*DAY_PARTS + MONTH_FRACT;
// The time of the new moon (in parts) on 1 Tishri, year 1 (the epoch) // counting from noon on the day before. BAHARAD is an abbreviation of // Bet (Monday), Hey (5 hours from sunset), Resh-Daled (204). staticconst int32_t BAHARAD = 11*HOUR_PARTS + 204;
namespace {
/** * Finds the day # of the first day in the given Hebrew year. * To do this, we want to calculate the time of the Tishri 1 new moon * in that year. * <p> * The algorithm here is similar to ones described in a number of * references, including: * <ul> * <li>"Calendrical Calculations", by Nachum Dershowitz & Edward Reingold, * Cambridge University Press, 1997, pages 85-91. * * <li>Hebrew Calendar Science and Myths, * <a href="http://www.geocities.com/Athens/1584/"> * http://www.geocities.com/Athens/1584/</a> * * <li>The Calendar FAQ, * <a href="http://www.faqs.org/faqs/calendars/faq/"> * http://www.faqs.org/faqs/calendars/faq/</a> * </ul>
*/
int32_t startOfYear(int32_t year, UErrorCode &status)
{
ucln_i18n_registerCleanup(UCLN_I18N_HEBREW_CALENDAR, calendar_hebrew_cleanup);
int64_t day = CalendarCache::get(&gCache, year, status); if(U_FAILURE(status)) { return 0;
}
if (day == 0) { // # of months before year
int64_t months = ClockMath::floorDivideInt64(
(235LL * static_cast<int64_t>(year) - 234LL), 19LL);
int64_t frac = months * MONTH_FRACT + BAHARAD; // Fractional part of day #
day = months * 29LL + frac / DAY_PARTS; // Whole # part of calculation
frac = frac % DAY_PARTS; // Time of day
int32_t wd = (day % 7); // Day of week (0 == Monday)
if (wd == 2 || wd == 4 || wd == 6) { // If the 1st is on Sun, Wed, or Fri, postpone to the next day
day += 1;
wd = (day % 7);
} if (wd == 1 && frac > 15*HOUR_PARTS+204 && !HebrewCalendar::isLeapYear(year) ) { // If the new moon falls after 3:11:20am (15h204p from the previous noon) // on a Tuesday and it is not a leap year, postpone by 2 days. // This prevents 356-day years.
day += 2;
} elseif (wd == 0 && frac > 21*HOUR_PARTS+589 && HebrewCalendar::isLeapYear(year-1) ) { // If the new moon falls after 9:32:43 1/3am (21h589p from yesterday noon) // on a Monday and *last* year was a leap year, postpone by 1 day. // Prevents 382-day years.
day += 1;
} if (day > INT32_MAX || day < INT32_MIN) {
status = U_ILLEGAL_ARGUMENT_ERROR; return 0;
}
CalendarCache::put(&gCache, year, static_cast<int32_t>(day), status);
} // Out of range value is alread rejected before putting into cache.
U_ASSERT(INT32_MIN <= day && day <= INT32_MAX); return day;
}
/** * Returns the the type of a given year. * 0 "Deficient" year with 353 or 383 days * 1 "Normal" year with 354 or 384 days * 2 "Complete" year with 355 or 385 days
*/
int32_t yearType(int32_t year, UErrorCode& status)
{ if (U_FAILURE(status)) { return 0;
}
int32_t yearLength = daysInYear(year, status); if (U_FAILURE(status)) { return 0;
}
if (yearLength > 380) {
yearLength -= 30; // Subtract length of leap month.
}
int type = 0;
switch (yearLength) { case 353:
type = 0; break; case 354:
type = 1; break; case 355:
type = 2; break; default: //throw new RuntimeException("Illegal year length " + yearLength + " in year " + year);
type = 1;
} return type;
}
} // namespace // /** * Determine whether a given Hebrew year is a leap year * * The rule here is that if (year % 19) == 0, 3, 6, 8, 11, 14, or 17. * The formula below performs the same test, believe it or not.
*/
UBool HebrewCalendar::isLeapYear(int32_t year) { //return (year * 12 + 17) % 19 >= 12;
int64_t x = (year*12LL + 17) % YEARS_IN_CYCLE; return x >= ((x < 0) ? -7 : 12);
}
/** * Returns the length of the given month in the given year * @internal
*/
int32_t HebrewCalendar::handleGetMonthLength(int32_t extendedYear, int32_t month, UErrorCode& status) const { if(U_FAILURE(status)) { return 0;
} // Resolve out-of-range months. This is necessary in order to // obtain the correct year. We correct to // a 12- or 13-month year (add/subtract 12 or 13, depending // on the year) but since we _always_ number from 0..12, and // the leap year determines whether or not month 5 (Adar 1) // is present, we allow 0..12 in any given year. while (month < 0) {
month += monthsInYear(--extendedYear);
} // Careful: allow 0..12 in all years while (month > 12) {
month -= monthsInYear(extendedYear++);
}
switch (month) { case HESHVAN: case KISLEV:
{ // These two month lengths can vary
int32_t type = yearType(extendedYear, status); if(U_FAILURE(status)) { return 0;
} return MONTH_LENGTH[month][type];
}
default: // The rest are a fixed length return MONTH_LENGTH[month][0];
}
}
/** * Returns the number of days in the given Hebrew year * @internal
*/
int32_t HebrewCalendar::handleGetYearLength(int32_t eyear) const {
UErrorCode status = U_ZERO_ERROR;
int32_t len = daysInYear(eyear, status); if (U_FAILURE(status)) { return 12;
} return len;
}
void HebrewCalendar::validateField(UCalendarDateFields field, UErrorCode &status) { if ((field == UCAL_MONTH || field == UCAL_ORDINAL_MONTH)
&& !isLeapYear(handleGetExtendedYear(status)) && internalGetMonth(status) == ADAR_1) { if (U_FAILURE(status)) { return;
}
status = U_ILLEGAL_ARGUMENT_ERROR; return;
}
Calendar::validateField(field, status);
} //------------------------------------------------------------------------- // Functions for converting from milliseconds to field values //-------------------------------------------------------------------------
/** * Subclasses may override this method to compute several fields * specific to each calendar system. These are: * * <ul><li>ERA * <li>YEAR * <li>MONTH * <li>DAY_OF_MONTH * <li>DAY_OF_YEAR * <li>EXTENDED_YEAR</ul> * * Subclasses can refer to the DAY_OF_WEEK and DOW_LOCAL fields, * which will be set when this method is called. Subclasses can * also call the getGregorianXxx() methods to obtain Gregorian * calendar equivalents for the given Julian day. * * <p>In addition, subclasses should compute any subclass-specific * fields, that is, fields from BASE_FIELD_COUNT to * getFieldCount() - 1. * @internal
*/ void HebrewCalendar::handleComputeFields(int32_t julianDay, UErrorCode &status) { if (U_FAILURE(status)) { return;
}
int32_t d = julianDay - 347997; double m = ClockMath::floorDivide((d * static_cast<double>(DAY_PARTS)), static_cast<double>(MONTH_PARTS)); // Months (approx)
int32_t year = static_cast<int32_t>(ClockMath::floorDivide((19. * m + 234.), 235.) + 1.); // Years (approx)
int32_t ys = startOfYear(year, status); // 1st day of year if (U_FAILURE(status)) { return;
}
int32_t dayOfYear = (d - ys);
// Because of the postponement rules, it's possible to guess wrong. Fix it. while (dayOfYear < 1) {
year--;
ys = startOfYear(year, status); if (U_FAILURE(status)) { return;
}
dayOfYear = (d - ys);
}
// Now figure out which month we're in, and the date within that month
int32_t type = yearType(year, status); if (U_FAILURE(status)) { return;
}
UBool isLeap = isLeapYear(year);
int32_t month = 0;
int32_t momax = UPRV_LENGTHOF(MONTH_START); while (month < momax &&
dayOfYear > ( isLeap ? LEAP_MONTH_START[month][type] : MONTH_START[month][type] ) ) {
month++;
} if (month >= momax || month<=0) { // TODO: I found dayOfYear could be out of range when // a large value is set to julianDay. I patched startOfYear // to reduce the chace, but it could be still reproduced either // by startOfYear or other places. For now, we check // the month is in valid range to avoid out of array index // access problem here. However, we need to carefully review // the calendar implementation to check the extreme limit of // each calendar field and the code works well for any values // in the valid value range. -yoshito
status = U_ILLEGAL_ARGUMENT_ERROR; return;
}
month--; int dayOfMonth = dayOfYear - (isLeap ? LEAP_MONTH_START[month][type] : MONTH_START[month][type]);
internalSet(UCAL_ERA, 0); // Check out of bound year
int32_t min_year = handleGetLimit(UCAL_EXTENDED_YEAR, UCAL_LIMIT_MINIMUM); if (year < min_year) { if (!isLenient()) {
status = U_ILLEGAL_ARGUMENT_ERROR; return;
}
year = min_year;
}
int32_t max_year = handleGetLimit(UCAL_EXTENDED_YEAR, UCAL_LIMIT_MAXIMUM); if (max_year < year) { if (!isLenient()) {
status = U_ILLEGAL_ARGUMENT_ERROR; return;
}
year = max_year;
}
internalSet(UCAL_YEAR, year);
internalSet(UCAL_EXTENDED_YEAR, year);
int32_t ordinal_month = month; if (!isLeap && ordinal_month > ADAR_1) {
ordinal_month--;
}
internalSet(UCAL_ORDINAL_MONTH, ordinal_month);
internalSet(UCAL_MONTH, month);
internalSet(UCAL_DAY_OF_MONTH, dayOfMonth);
internalSet(UCAL_DAY_OF_YEAR, dayOfYear);
}
//------------------------------------------------------------------------- // Functions for converting from field values to milliseconds //-------------------------------------------------------------------------
/** * @internal
*/
int32_t HebrewCalendar::handleGetExtendedYear(UErrorCode& status ) { if (U_FAILURE(status)) { return 0;
} if (newerField(UCAL_EXTENDED_YEAR, UCAL_YEAR) == UCAL_EXTENDED_YEAR) { return internalGet(UCAL_EXTENDED_YEAR, 1); // Default to year 1
} return internalGet(UCAL_YEAR, 1); // Default to year 1
}
/** * Return JD of start of given month/year. * @internal
*/
int64_t HebrewCalendar::handleComputeMonthStart(
int32_t eyear, int32_t month, UBool /*useMonth*/, UErrorCode& status) const { if (U_FAILURE(status)) { return 0;
} // Resolve out-of-range months. This is necessary in order to // obtain the correct year. We correct to // a 12- or 13-month year (add/subtract 12 or 13, depending // on the year) but since we _always_ number from 0..12, and // the leap year determines whether or not month 5 (Adar 1) // is present, we allow 0..12 in any given year.
// The month could be in large value, we first roll 235 months to 19 years // before the while loop. if (month <= -MONTHS_IN_CYCLE || month >= MONTHS_IN_CYCLE) { if (uprv_add32_overflow(eyear, (month / MONTHS_IN_CYCLE) * YEARS_IN_CYCLE, &eyear)) {
status = U_ILLEGAL_ARGUMENT_ERROR; return 0;
}
month %= MONTHS_IN_CYCLE;
} while (month < 0) { if (uprv_add32_overflow(eyear, -1, &eyear) ||
uprv_add32_overflow(month, monthsInYear(eyear), &month)) {
status = U_ILLEGAL_ARGUMENT_ERROR; return 0;
}
} // Careful: allow 0..12 in all years while (month > 12) { if (uprv_add32_overflow(month, -monthsInYear(eyear), &month) ||
uprv_add32_overflow(eyear, 1, &eyear)) {
status = U_ILLEGAL_ARGUMENT_ERROR; return 0;
}
}
int64_t day = startOfYear(eyear, status);
if(U_FAILURE(status)) { return 0;
}
if (month != 0) {
int32_t type = yearType(eyear, status); if (U_FAILURE(status)) { return 0;
} if (isLeapYear(eyear)) {
day += LEAP_MONTH_START[month][type];
} else {
day += MONTH_START[month][type];
}
}
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung und die Messung sind noch experimentell.