17935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert/* 2f716bda031dccdec5e47bb40e758c5901d209729Fredrik Roubert * Copyright (C) 1996-2015, International Business Machines 37935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Corporation and others. All Rights Reserved. 47935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 57935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 67935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubertpackage com.ibm.icu.util; 77935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 87935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubertimport java.util.Date; 97935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubertimport java.util.Locale; 107935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 117935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubertimport com.ibm.icu.util.ULocale.Category; 127935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 137935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert/** 147935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * {@icuenhanced java.util.GregorianCalendar}.{@icu _usage_} 157935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 167935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <p><code>GregorianCalendar</code> is a concrete subclass of 177935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * {@link Calendar} 187935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * and provides the standard calendar used by most of the world. 197935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 207935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <p>The standard (Gregorian) calendar has 2 eras, BC and AD. 217935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 227935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <p>This implementation handles a single discontinuity, which corresponds by 237935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * default to the date the Gregorian calendar was instituted (October 15, 1582 247935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * in some countries, later in others). The cutover date may be changed by the 257935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * caller by calling <code>setGregorianChange()</code>. 267935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 277935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <p>Historically, in those countries which adopted the Gregorian calendar first, 287935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * October 4, 1582 was thus followed by October 15, 1582. This calendar models 297935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * this correctly. Before the Gregorian cutover, <code>GregorianCalendar</code> 307935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * implements the Julian calendar. The only difference between the Gregorian 317935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * and the Julian calendar is the leap year rule. The Julian calendar specifies 327935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * leap years every four years, whereas the Gregorian calendar omits century 337935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * years which are not divisible by 400. 347935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 357935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <p><code>GregorianCalendar</code> implements <em>proleptic</em> Gregorian and 367935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Julian calendars. That is, dates are computed by extrapolating the current 377935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * rules indefinitely far backward and forward in time. As a result, 387935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <code>GregorianCalendar</code> may be used for all years to generate 397935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * meaningful and consistent results. However, dates obtained using 407935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <code>GregorianCalendar</code> are historically accurate only from March 1, 4 417935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * AD onward, when modern Julian calendar rules were adopted. Before this date, 427935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * leap year rules were applied irregularly, and before 45 BC the Julian 437935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * calendar did not even exist. 447935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 457935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <p>Prior to the institution of the Gregorian calendar, New Year's Day was 467935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * March 25. To avoid confusion, this calendar always uses January 1. A manual 477935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * adjustment may be made if desired for dates that are prior to the Gregorian 487935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * changeover and which fall between January 1 and March 24. 497935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 507935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <p>Values calculated for the <code>WEEK_OF_YEAR</code> field range from 1 to 517935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 53. Week 1 for a year is the earliest seven day period starting on 527935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <code>getFirstDayOfWeek()</code> that contains at least 537935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <code>getMinimalDaysInFirstWeek()</code> days from that year. It thus 547935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * depends on the values of <code>getMinimalDaysInFirstWeek()</code>, 557935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <code>getFirstDayOfWeek()</code>, and the day of the week of January 1. 567935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Weeks between week 1 of one year and week 1 of the following year are 577935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * numbered sequentially from 2 to 52 or 53 (as needed). 587935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 597935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <p>For example, January 1, 1998 was a Thursday. If 607935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <code>getFirstDayOfWeek()</code> is <code>MONDAY</code> and 617935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <code>getMinimalDaysInFirstWeek()</code> is 4 (these are the values 627935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * reflecting ISO 8601 and many national standards), then week 1 of 1998 starts 637935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * on December 29, 1997, and ends on January 4, 1998. If, however, 647935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <code>getFirstDayOfWeek()</code> is <code>SUNDAY</code>, then week 1 of 1998 657935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * starts on January 4, 1998, and ends on January 10, 1998; the first three days 667935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * of 1998 then are part of week 53 of 1997. 677935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 687935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <p>Values calculated for the <code>WEEK_OF_MONTH</code> field range from 0 or 697935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 1 to 4 or 5. Week 1 of a month (the days with <code>WEEK_OF_MONTH = 707935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 1</code>) is the earliest set of at least 717935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <code>getMinimalDaysInFirstWeek()</code> contiguous days in that month, 727935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * ending on the day before <code>getFirstDayOfWeek()</code>. Unlike 737935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * week 1 of a year, week 1 of a month may be shorter than 7 days, need 747935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * not start on <code>getFirstDayOfWeek()</code>, and will not include days of 757935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * the previous month. Days of a month before week 1 have a 767935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <code>WEEK_OF_MONTH</code> of 0. 777935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 787935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <p>For example, if <code>getFirstDayOfWeek()</code> is <code>SUNDAY</code> 797935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * and <code>getMinimalDaysInFirstWeek()</code> is 4, then the first week of 807935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * January 1998 is Sunday, January 4 through Saturday, January 10. These days 817935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * have a <code>WEEK_OF_MONTH</code> of 1. Thursday, January 1 through 827935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Saturday, January 3 have a <code>WEEK_OF_MONTH</code> of 0. If 837935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <code>getMinimalDaysInFirstWeek()</code> is changed to 3, then January 1 847935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * through January 3 have a <code>WEEK_OF_MONTH</code> of 1. 857935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 867935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <p> 877935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <strong>Example:</strong> 887935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <blockquote> 897935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <pre> 907935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * // get the supported ids for GMT-08:00 (Pacific Standard Time) 917935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * String[] ids = TimeZone.getAvailableIDs(-8 * 60 * 60 * 1000); 927935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * // if no ids were returned, something is wrong. get out. 937935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * if (ids.length == 0) 947935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.exit(0); 957935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 967935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * // begin output 977935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("Current Time"); 987935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 997935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * // create a Pacific Standard Time time zone 1007935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * SimpleTimeZone pdt = new SimpleTimeZone(-8 * 60 * 60 * 1000, ids[0]); 1017935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 1027935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * // set up rules for daylight savings time 1037935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * pdt.setStartRule(Calendar.MARCH, 2, Calendar.SUNDAY, 2 * 60 * 60 * 1000); 1047935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * pdt.setEndRule(Calendar.NOVEMBER, 1, Calendar.SUNDAY, 2 * 60 * 60 * 1000); 1057935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 1067935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * // create a GregorianCalendar with the Pacific Daylight time zone 1077935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * // and the current date and time 1087935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Calendar calendar = new GregorianCalendar(pdt); 1097935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Date trialTime = new Date(); 1107935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * calendar.setTime(trialTime); 1117935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 1127935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * // print out a bunch of interesting things 1137935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("ERA: " + calendar.get(Calendar.ERA)); 1147935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("YEAR: " + calendar.get(Calendar.YEAR)); 1157935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("MONTH: " + calendar.get(Calendar.MONTH)); 1167935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("WEEK_OF_YEAR: " + calendar.get(Calendar.WEEK_OF_YEAR)); 1177935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("WEEK_OF_MONTH: " + calendar.get(Calendar.WEEK_OF_MONTH)); 1187935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("DATE: " + calendar.get(Calendar.DATE)); 1197935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("DAY_OF_MONTH: " + calendar.get(Calendar.DAY_OF_MONTH)); 1207935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("DAY_OF_YEAR: " + calendar.get(Calendar.DAY_OF_YEAR)); 1217935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("DAY_OF_WEEK: " + calendar.get(Calendar.DAY_OF_WEEK)); 1227935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("DAY_OF_WEEK_IN_MONTH: " 1237935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * + calendar.get(Calendar.DAY_OF_WEEK_IN_MONTH)); 1247935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("AM_PM: " + calendar.get(Calendar.AM_PM)); 1257935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("HOUR: " + calendar.get(Calendar.HOUR)); 1267935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("HOUR_OF_DAY: " + calendar.get(Calendar.HOUR_OF_DAY)); 1277935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("MINUTE: " + calendar.get(Calendar.MINUTE)); 1287935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("SECOND: " + calendar.get(Calendar.SECOND)); 1297935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("MILLISECOND: " + calendar.get(Calendar.MILLISECOND)); 1307935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("ZONE_OFFSET: " 1317935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * + (calendar.get(Calendar.ZONE_OFFSET)/(60*60*1000))); 1327935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("DST_OFFSET: " 1337935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * + (calendar.get(Calendar.DST_OFFSET)/(60*60*1000))); 1347935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 1357935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("Current Time, with hour reset to 3"); 1367935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * calendar.clear(Calendar.HOUR_OF_DAY); // so doesn't override 1377935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * calendar.set(Calendar.HOUR, 3); 1387935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("ERA: " + calendar.get(Calendar.ERA)); 1397935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("YEAR: " + calendar.get(Calendar.YEAR)); 1407935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("MONTH: " + calendar.get(Calendar.MONTH)); 1417935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("WEEK_OF_YEAR: " + calendar.get(Calendar.WEEK_OF_YEAR)); 1427935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("WEEK_OF_MONTH: " + calendar.get(Calendar.WEEK_OF_MONTH)); 1437935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("DATE: " + calendar.get(Calendar.DATE)); 1447935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("DAY_OF_MONTH: " + calendar.get(Calendar.DAY_OF_MONTH)); 1457935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("DAY_OF_YEAR: " + calendar.get(Calendar.DAY_OF_YEAR)); 1467935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("DAY_OF_WEEK: " + calendar.get(Calendar.DAY_OF_WEEK)); 1477935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("DAY_OF_WEEK_IN_MONTH: " 1487935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * + calendar.get(Calendar.DAY_OF_WEEK_IN_MONTH)); 1497935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("AM_PM: " + calendar.get(Calendar.AM_PM)); 1507935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("HOUR: " + calendar.get(Calendar.HOUR)); 1517935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("HOUR_OF_DAY: " + calendar.get(Calendar.HOUR_OF_DAY)); 1527935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("MINUTE: " + calendar.get(Calendar.MINUTE)); 1537935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("SECOND: " + calendar.get(Calendar.SECOND)); 1547935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("MILLISECOND: " + calendar.get(Calendar.MILLISECOND)); 1557935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("ZONE_OFFSET: " 1567935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * + (calendar.get(Calendar.ZONE_OFFSET)/(60*60*1000))); // in hours 1577935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * System.out.println("DST_OFFSET: " 1587935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * + (calendar.get(Calendar.DST_OFFSET)/(60*60*1000))); // in hours</pre> 1597935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * </blockquote> 1607935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <p> 1617935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * GregorianCalendar usually should be instantiated using 1627935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * {@link com.ibm.icu.util.Calendar#getInstance(ULocale)} passing in a <code>ULocale</code> 1637935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * with the tag <code>"@calendar=gregorian"</code>.</p> 1647935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 1657935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @see Calendar 1667935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @see TimeZone 1677935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @author David Goldsmith, Mark Davis, Chen-Lieh Huang, Alan Liu 1687935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 1697935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 1707935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubertpublic class GregorianCalendar extends Calendar { 1717935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // jdk1.4.2 serialver 1727935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert private static final long serialVersionUID = 9199388694351062137L; 1737935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 1747935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /* 1757935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Implementation Notes 1767935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 1777935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * The Julian day number, as used here, is a modified number which has its 1787935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * onset at midnight, rather than noon. 1797935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 1807935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * The epoch is the number of days or milliseconds from some defined 1817935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * starting point. The epoch for java.util.Date is used here; that is, 1827935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * milliseconds from January 1, 1970 (Gregorian), midnight UTC. Other 1837935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * epochs which are used are January 1, year 1 (Gregorian), which is day 1 1847935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * of the Gregorian calendar, and December 30, year 0 (Gregorian), which is 1857935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * day 1 of the Julian calendar. 1867935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 1877935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * We implement the proleptic Julian and Gregorian calendars. This means we 1887935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * implement the modern definition of the calendar even though the 1897935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * historical usage differs. For example, if the Gregorian change is set 1907935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * to new Date(Long.MIN_VALUE), we have a pure Gregorian calendar which 1917935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * labels dates preceding the invention of the Gregorian calendar in 1582 as 1927935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * if the calendar existed then. 1937935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 1947935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Likewise, with the Julian calendar, we assume a consistent 4-year leap 1957935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * rule, even though the historical pattern of leap years is irregular, 1967935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * being every 3 years from 45 BC through 9 BC, then every 4 years from 8 AD 1977935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * onwards, with no leap years in-between. Thus date computations and 1987935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * functions such as isLeapYear() are not intended to be historically 1997935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * accurate. 2007935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 2017935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Given that milliseconds are a long, day numbers such as Julian day 2027935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * numbers, Gregorian or Julian calendar days, or epoch days, are also 2037935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * longs. Years can fit into an int. 2047935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 2057935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 2067935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert////////////////// 2077935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert// Class Variables 2087935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert////////////////// 2097935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 2107935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 2117935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Value of the <code>ERA</code> field indicating 2127935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * the period before the common era (before Christ), also known as BCE. 2137935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * The sequence of years at the transition from <code>BC</code> to <code>AD</code> is 2147935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * ..., 2 BC, 1 BC, 1 AD, 2 AD,... 2157935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @see Calendar#ERA 2167935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 2177935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 2187935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public static final int BC = 0; 2197935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 2207935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 2217935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Value of the <code>ERA</code> field indicating 2227935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * the common era (Anno Domini), also known as CE. 2237935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * The sequence of years at the transition from <code>BC</code> to <code>AD</code> is 2247935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * ..., 2 BC, 1 BC, 1 AD, 2 AD,... 2257935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @see Calendar#ERA 2267935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 2277935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 2287935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public static final int AD = 1; 2297935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 2307935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert private static final int EPOCH_YEAR = 1970; 2317935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 2327935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert private static final int[][] MONTH_COUNT = { 2337935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert //len len2 st st2 2347935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 31, 31, 0, 0 }, // Jan 2357935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 28, 29, 31, 31 }, // Feb 2367935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 31, 31, 59, 60 }, // Mar 2377935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 30, 30, 90, 91 }, // Apr 2387935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 31, 31, 120, 121 }, // May 2397935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 30, 30, 151, 152 }, // Jun 2407935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 31, 31, 181, 182 }, // Jul 2417935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 31, 31, 212, 213 }, // Aug 2427935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 30, 30, 243, 244 }, // Sep 2437935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 31, 31, 273, 274 }, // Oct 2447935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 30, 30, 304, 305 }, // Nov 2457935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 31, 31, 334, 335 } // Dec 2467935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // len length of month 2477935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // len2 length of month in a leap year 2487935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // st days in year before start of month 2497935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // st2 days in year before month in leap year 2507935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert }; 2517935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 2527935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 2537935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Old year limits were least max 292269054, max 292278994. 2547935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 2557935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert private static final int LIMITS[][] = { 2567935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // Minimum Greatest Least Maximum 2577935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // Minimum Maximum 2587935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 0, 0, 1, 1 }, // ERA 2597935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 1, 1, 5828963, 5838270 }, // YEAR 2607935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 0, 0, 11, 11 }, // MONTH 2617935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 1, 1, 52, 53 }, // WEEK_OF_YEAR 2627935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert {/* */}, // WEEK_OF_MONTH 2637935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 1, 1, 28, 31 }, // DAY_OF_MONTH 2647935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 1, 1, 365, 366 }, // DAY_OF_YEAR 2657935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert {/* */}, // DAY_OF_WEEK 2667935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { -1, -1, 4, 5 }, // DAY_OF_WEEK_IN_MONTH 2677935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert {/* */}, // AM_PM 2687935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert {/* */}, // HOUR 2697935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert {/* */}, // HOUR_OF_DAY 2707935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert {/* */}, // MINUTE 2717935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert {/* */}, // SECOND 2727935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert {/* */}, // MILLISECOND 2737935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert {/* */}, // ZONE_OFFSET 2747935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert {/* */}, // DST_OFFSET 2757935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { -5838270, -5838270, 5828964, 5838271 }, // YEAR_WOY 2767935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert {/* */}, // DOW_LOCAL 2777935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { -5838269, -5838269, 5828963, 5838270 }, // EXTENDED_YEAR 2787935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert {/* */}, // JULIAN_DAY 2797935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert {/* */}, // MILLISECONDS_IN_DAY 280f716bda031dccdec5e47bb40e758c5901d209729Fredrik Roubert {/* */}, // IS_LEAP_MONTH 2817935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert }; 2827935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 2837935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 2847935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 2857935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 2867935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert protected int handleGetLimit(int field, int limitType) { 2877935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return LIMITS[field][limitType]; 2887935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 2897935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 2907935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert///////////////////// 2917935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert// Instance Variables 2927935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert///////////////////// 2937935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 2947935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 2957935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * The point at which the Gregorian calendar rules are used, measured in 2967935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * milliseconds from the standard epoch. Default is October 15, 1582 2977935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * (Gregorian) 00:00:00 UTC or -12219292800000L. For this value, October 4, 2987935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 1582 (Julian) is followed by October 15, 1582 (Gregorian). This 2997935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * corresponds to Julian day number 2299161. 3007935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @serial 3017935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 3027935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert private long gregorianCutover = -12219292800000L; 3037935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 3047935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 3057935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Julian day number of the Gregorian cutover. 3067935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 3077935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert private transient int cutoverJulianDay = 2299161; 3087935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 3097935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 3107935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * The year of the gregorianCutover, with 0 representing 3117935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 1 BC, -1 representing 2 BC, etc. 3127935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 3137935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert private transient int gregorianCutoverYear = 1582; 3147935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 3157935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 3167935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Used by handleComputeJulianDay() and handleComputeMonthStart(). 3177935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 3187935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 3197935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert transient protected boolean isGregorian; 3207935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 3217935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 3227935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Used by handleComputeJulianDay() and handleComputeMonthStart(). 3237935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 3247935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 3257935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert transient protected boolean invertGregorian; 3267935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 3277935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert/////////////// 3287935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert// Constructors 3297935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert/////////////// 3307935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 3317935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 3327935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Constructs a default GregorianCalendar using the current time 3337935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * in the default time zone with the default <code>FORMAT</code> locale. 3347935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @see Category#FORMAT 3357935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 3367935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 3377935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public GregorianCalendar() { 3387935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert this(TimeZone.getDefault(), ULocale.getDefault(Category.FORMAT)); 3397935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 3407935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 3417935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 3427935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Constructs a GregorianCalendar based on the current time 3437935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * in the given time zone with the default <code>FORMAT</code> locale. 3447935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param zone the given time zone. 3457935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @see Category#FORMAT 3467935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 3477935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 3487935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public GregorianCalendar(TimeZone zone) { 3497935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert this(zone, ULocale.getDefault(Category.FORMAT)); 3507935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 3517935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 3527935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 3537935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Constructs a GregorianCalendar based on the current time 3547935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * in the default time zone with the given locale. 3557935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param aLocale the given locale. 3567935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 3577935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 3587935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public GregorianCalendar(Locale aLocale) { 3597935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert this(TimeZone.getDefault(), aLocale); 3607935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 3617935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 3627935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 3637935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * {@icu} Constructs a GregorianCalendar based on the current time 3647935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * in the default time zone with the given locale. 3657935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param locale the given ulocale. 3667935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 3.2 3677935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 3687935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public GregorianCalendar(ULocale locale) { 3697935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert this(TimeZone.getDefault(), locale); 3707935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 3717935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 3727935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 3737935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * {@icu} Constructs a GregorianCalendar based on the current time 3747935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * in the given time zone with the given locale. 3757935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param zone the given time zone. 3767935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param aLocale the given locale. 3777935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 3787935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 3797935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public GregorianCalendar(TimeZone zone, Locale aLocale) { 3807935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert super(zone, aLocale); 3817935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert setTimeInMillis(System.currentTimeMillis()); 3827935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 3837935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 3847935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 3857935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Constructs a GregorianCalendar based on the current time 3867935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * in the given time zone with the given locale. 3877935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param zone the given time zone. 3887935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param locale the given ulocale. 3897935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 3.2 3907935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 3917935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public GregorianCalendar(TimeZone zone, ULocale locale) { 3927935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert super(zone, locale); 3937935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert setTimeInMillis(System.currentTimeMillis()); 3947935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 3957935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 3967935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 3977935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Constructs a GregorianCalendar with the given date set 3987935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * in the default time zone with the default <code>FORMAT</code> locale. 3997935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param year the value used to set the YEAR time field in the calendar. 4007935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param month the value used to set the MONTH time field in the calendar. 4017935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Month value is 0-based. e.g., 0 for January. 4027935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param date the value used to set the DATE time field in the calendar. 4037935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @see Category#FORMAT 4047935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 4057935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 4067935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public GregorianCalendar(int year, int month, int date) { 4077935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert super(TimeZone.getDefault(), ULocale.getDefault(Category.FORMAT)); 4087935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(ERA, AD); 4097935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(YEAR, year); 4107935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(MONTH, month); 4117935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(DATE, date); 4127935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 4137935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 4147935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 4157935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Constructs a GregorianCalendar with the given date 4167935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * and time set for the default time zone with the default <code>FORMAT</code> locale. 4177935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param year the value used to set the YEAR time field in the calendar. 4187935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param month the value used to set the MONTH time field in the calendar. 4197935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Month value is 0-based. e.g., 0 for January. 4207935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param date the value used to set the DATE time field in the calendar. 4217935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param hour the value used to set the HOUR_OF_DAY time field 4227935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * in the calendar. 4237935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param minute the value used to set the MINUTE time field 4247935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * in the calendar. 4257935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @see Category#FORMAT 4267935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 4277935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 4287935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public GregorianCalendar(int year, int month, int date, int hour, 4297935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int minute) { 4307935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert super(TimeZone.getDefault(), ULocale.getDefault(Category.FORMAT)); 4317935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(ERA, AD); 4327935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(YEAR, year); 4337935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(MONTH, month); 4347935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(DATE, date); 4357935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(HOUR_OF_DAY, hour); 4367935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(MINUTE, minute); 4377935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 4387935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 4397935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 4407935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Constructs a GregorianCalendar with the given date 4417935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * and time set for the default time zone with the default <code>FORMAT</code> locale. 4427935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param year the value used to set the YEAR time field in the calendar. 4437935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param month the value used to set the MONTH time field in the calendar. 4447935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Month value is 0-based. e.g., 0 for January. 4457935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param date the value used to set the DATE time field in the calendar. 4467935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param hour the value used to set the HOUR_OF_DAY time field 4477935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * in the calendar. 4487935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param minute the value used to set the MINUTE time field 4497935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * in the calendar. 4507935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param second the value used to set the SECOND time field 4517935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * in the calendar. 4527935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @see Category#FORMAT 4537935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 4547935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 4557935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public GregorianCalendar(int year, int month, int date, int hour, 4567935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int minute, int second) { 4577935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert super(TimeZone.getDefault(), ULocale.getDefault(Category.FORMAT)); 4587935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(ERA, AD); 4597935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(YEAR, year); 4607935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(MONTH, month); 4617935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(DATE, date); 4627935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(HOUR_OF_DAY, hour); 4637935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(MINUTE, minute); 4647935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(SECOND, second); 4657935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 4667935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 4677935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert///////////////// 4687935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert// Public methods 4697935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert///////////////// 4707935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 4717935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 4727935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Sets the GregorianCalendar change date. This is the point when the switch 4737935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * from Julian dates to Gregorian dates occurred. Default is October 15, 4747935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 1582. Previous to this, dates will be in the Julian calendar. 4757935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <p> 4767935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * To obtain a pure Julian calendar, set the change date to 4777935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <code>Date(Long.MAX_VALUE)</code>. To obtain a pure Gregorian calendar, 4787935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * set the change date to <code>Date(Long.MIN_VALUE)</code>. 4797935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 4807935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param date the given Gregorian cutover date. 4817935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 4827935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 4837935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public void setGregorianChange(Date date) { 4847935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert gregorianCutover = date.getTime(); 4857935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 4867935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // If the cutover has an extreme value, then create a pure 4877935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // Gregorian or pure Julian calendar by giving the cutover year and 4887935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // JD extreme values. 4897935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (gregorianCutover <= MIN_MILLIS) { 4907935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert gregorianCutoverYear = cutoverJulianDay = Integer.MIN_VALUE; 4917935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } else if (gregorianCutover >= MAX_MILLIS) { 4927935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert gregorianCutoverYear = cutoverJulianDay = Integer.MAX_VALUE; 4937935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } else { 4947935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // Precompute two internal variables which we use to do the actual 4957935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // cutover computations. These are the Julian day of the cutover 4967935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // and the cutover year. 4977935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert cutoverJulianDay = (int) floorDivide(gregorianCutover, ONE_DAY); 4987935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 4997935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // Convert cutover millis to extended year 5007935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert GregorianCalendar cal = new GregorianCalendar(getTimeZone()); 5017935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert cal.setTime(date); 5027935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert gregorianCutoverYear = cal.get(EXTENDED_YEAR); 5037935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 5047935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 5057935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 5067935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 5077935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Gets the Gregorian Calendar change date. This is the point when the 5087935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * switch from Julian dates to Gregorian dates occurred. Default is 5097935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * October 15, 1582. Previous to this, dates will be in the Julian 5107935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * calendar. 5117935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @return the Gregorian cutover date for this calendar. 5127935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 5137935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 5147935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public final Date getGregorianChange() { 5157935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return new Date(gregorianCutover); 5167935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 5177935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 5187935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 5197935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Determines if the given year is a leap year. Returns true if the 5207935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * given year is a leap year. 5217935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param year the given year. 5227935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @return true if the given year is a leap year; false otherwise. 5237935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 5247935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 5257935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public boolean isLeapYear(int year) { 5267935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return year >= gregorianCutoverYear ? 5277935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert ((year%4 == 0) && ((year%100 != 0) || (year%400 == 0))) : // Gregorian 5287935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert (year%4 == 0); // Julian 5297935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 5307935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 5317935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 5327935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Returns true if the given Calendar object is equivalent to this 5337935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * one. Calendar override. 5347935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 5357935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @param other the Calendar to be compared with this Calendar 5367935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.4 5377935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 5387935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public boolean isEquivalentTo(Calendar other) { 5397935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return super.isEquivalentTo(other) && 5407935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert gregorianCutover == ((GregorianCalendar)other).gregorianCutover; 5417935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 5427935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 5437935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 5447935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Override hashCode. 5457935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Generates the hash code for the GregorianCalendar object 5467935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 5477935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 5487935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public int hashCode() { 5497935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return super.hashCode() ^ (int)gregorianCutover; 5507935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 5517935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 5527935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 5537935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Roll a field by a signed amount. 5547935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 5557935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 5567935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public void roll(int field, int amount) { 5577935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 5587935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert switch (field) { 5597935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert case WEEK_OF_YEAR: 5607935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 5617935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // Unlike WEEK_OF_MONTH, WEEK_OF_YEAR never shifts the day of the 5627935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // week. Also, rolling the week of the year can have seemingly 5637935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // strange effects simply because the year of the week of year 5647935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // may be different from the calendar year. For example, the 5657935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // date Dec 28, 1997 is the first day of week 1 of 1998 (if 5667935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // weeks start on Sunday and the minimal days in first week is 5677935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // <= 3). 5687935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int woy = get(WEEK_OF_YEAR); 5697935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // Get the ISO year, which matches the week of year. This 5707935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // may be one year before or after the calendar year. 5717935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int isoYear = get(YEAR_WOY); 5727935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int isoDoy = internalGet(DAY_OF_YEAR); 5737935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (internalGet(MONTH) == Calendar.JANUARY) { 5747935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (woy >= 52) { 5757935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert isoDoy += handleGetYearLength(isoYear); 5767935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 5777935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } else { 5787935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (woy == 1) { 5797935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert isoDoy -= handleGetYearLength(isoYear - 1); 5807935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 5817935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 5827935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert woy += amount; 5837935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // Do fast checks to avoid unnecessary computation: 5847935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (woy < 1 || woy > 52) { 5857935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // Determine the last week of the ISO year. 5867935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // We do this using the standard formula we use 5877935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // everywhere in this file. If we can see that the 5887935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // days at the end of the year are going to fall into 5897935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // week 1 of the next year, we drop the last week by 5907935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // subtracting 7 from the last day of the year. 5917935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int lastDoy = handleGetYearLength(isoYear); 5927935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int lastRelDow = (lastDoy - isoDoy + internalGet(DAY_OF_WEEK) - 5937935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert getFirstDayOfWeek()) % 7; 5947935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (lastRelDow < 0) lastRelDow += 7; 5957935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if ((6 - lastRelDow) >= getMinimalDaysInFirstWeek()) lastDoy -= 7; 5967935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int lastWoy = weekNumber(lastDoy, lastRelDow + 1); 5977935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert woy = ((woy + lastWoy - 1) % lastWoy) + 1; 5987935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 5997935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(WEEK_OF_YEAR, woy); 6007935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert set(YEAR, isoYear); // Why not YEAR_WOY? - Alan 11/6/00 6017935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return; 6027935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 6037935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 6047935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert default: 6057935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert super.roll(field, amount); 6067935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return; 6077935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 6087935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 6097935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 6107935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 6117935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Return the minimum value that this field could have, given the current date. 6127935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * For the Gregorian calendar, this is the same as getMinimum() and getGreatestMinimum(). 6137935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 6147935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 6157935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public int getActualMinimum(int field) { 6167935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return getMinimum(field); 6177935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 6187935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 6197935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 6207935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Return the maximum value that this field could have, given the current date. 6217935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * For example, with the date "Feb 3, 1997" and the DAY_OF_MONTH field, the actual 6227935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * maximum would be 28; for "Feb 3, 1996" it s 29. Similarly for a Hebrew calendar, 6237935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * for some years the actual maximum for MONTH is 12, and for others 13. 6247935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 6257935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 6267935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public int getActualMaximum(int field) { 6277935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /* It is a known limitation that the code here (and in getActualMinimum) 6287935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * won't behave properly at the extreme limits of GregorianCalendar's 6297935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * representable range (except for the code that handles the YEAR 6307935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * field). That's because the ends of the representable range are at 6317935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * odd spots in the year. For calendars with the default Gregorian 6327935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * cutover, these limits are Sun Dec 02 16:47:04 GMT 292269055 BC to Sun 6337935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Aug 17 07:12:55 GMT 292278994 AD, somewhat different for non-GMT 6347935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * zones. As a result, if the calendar is set to Aug 1 292278994 AD, 6357935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * the actual maximum of DAY_OF_MONTH is 17, not 30. If the date is Mar 6367935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 31 in that year, the actual maximum month might be Jul, whereas is 6377935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * the date is Mar 15, the actual maximum might be Aug -- depending on 6387935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * the precise semantics that are desired. Similar considerations 6397935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * affect all fields. Nonetheless, this effect is sufficiently arcane 6407935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * that we permit it, rather than complicating the code to handle such 6417935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * intricacies. - liu 8/20/98 6427935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 6437935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * UPDATE: No longer true, since we have pulled in the limit values on 6447935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * the year. - Liu 11/6/00 */ 6457935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 6467935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert switch (field) { 6477935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 6487935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert case YEAR: 6497935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /* The year computation is no different, in principle, from the 6507935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * others, however, the range of possible maxima is large. In 6517935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * addition, the way we know we've exceeded the range is different. 6527935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * For these reasons, we use the special case code below to handle 6537935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * this field. 6547935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 6557935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * The actual maxima for YEAR depend on the type of calendar: 6567935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 6577935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Gregorian = May 17, 292275056 BC - Aug 17, 292278994 AD 6587935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Julian = Dec 2, 292269055 BC - Jan 3, 292272993 AD 6597935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Hybrid = Dec 2, 292269055 BC - Aug 17, 292278994 AD 6607935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 6617935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * We know we've exceeded the maximum when either the month, date, 6627935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * time, or era changes in response to setting the year. We don't 6637935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * check for month, date, and time here because the year and era are 6647935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * sufficient to detect an invalid year setting. NOTE: If code is 6657935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * added to check the month and date in the future for some reason, 6667935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Feb 29 must be allowed to shift to Mar 1 when setting the year. 6677935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 6687935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert { 6697935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert Calendar cal = (Calendar) clone(); 6707935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert cal.setLenient(true); 6717935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 6727935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int era = cal.get(ERA); 6737935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert Date d = cal.getTime(); 6747935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 6757935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /* Perform a binary search, with the invariant that lowGood is a 6767935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * valid year, and highBad is an out of range year. 6777935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 6787935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int lowGood = LIMITS[YEAR][1]; 6797935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int highBad = LIMITS[YEAR][2]+1; 6807935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert while ((lowGood + 1) < highBad) { 6817935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int y = (lowGood + highBad) / 2; 6827935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert cal.set(YEAR, y); 6837935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (cal.get(YEAR) == y && cal.get(ERA) == era) { 6847935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert lowGood = y; 6857935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } else { 6867935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert highBad = y; 6877935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert cal.setTime(d); // Restore original fields 6887935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 6897935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 6907935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 6917935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return lowGood; 6927935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 6937935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 6947935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert default: 6957935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return super.getActualMaximum(field); 6967935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 6977935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 6987935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 6997935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert////////////////////// 7007935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert// Proposed public API 7017935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert////////////////////// 7027935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 7037935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 7047935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Return true if the current time for this Calendar is in Daylignt 7057935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Savings Time. 7067935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 7077935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert boolean inDaylightTime() { 7087935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (!getTimeZone().useDaylightTime()) return false; 7097935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert complete(); // Force update of DST_OFFSET field 7107935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return internalGet(DST_OFFSET) != 0; 7117935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 7127935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 7137935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 7147935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert///////////////////// 7157935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert// Calendar framework 7167935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert///////////////////// 7177935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 7187935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 7197935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 7207935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 7217935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert protected int handleGetMonthLength(int extendedYear, int month) { 7227935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // If the month is out of range, adjust it into range, and 7237935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // modify the extended year value accordingly. 7247935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (month < 0 || month > 11) { 7257935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int[] rem = new int[1]; 7267935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert extendedYear += floorDivide(month, 12, rem); 7277935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert month = rem[0]; 7287935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 7297935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 7307935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return MONTH_COUNT[month][isLeapYear(extendedYear)?1:0]; 7317935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 7327935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 7337935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 7347935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 7357935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 7367935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert protected int handleGetYearLength(int eyear) { 7377935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return isLeapYear(eyear) ? 366 : 365; 7387935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 7397935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 7407935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert///////////////////////////// 7417935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert// Time => Fields computation 7427935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert///////////////////////////// 7437935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 7447935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 7457935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Override Calendar to compute several fields specific to the hybrid 7467935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Gregorian-Julian calendar system. These are: 7477935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * 7487935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <ul><li>ERA 7497935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <li>YEAR 7507935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <li>MONTH 7517935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <li>DAY_OF_MONTH 7527935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <li>DAY_OF_YEAR 7537935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * <li>EXTENDED_YEAR</ul> 7547935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 7557935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 7567935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert protected void handleComputeFields(int julianDay) { 7577935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int eyear, month, dayOfMonth, dayOfYear; 7587935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 7597935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (julianDay >= cutoverJulianDay) { 7607935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert month = getGregorianMonth(); 7617935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert dayOfMonth = getGregorianDayOfMonth(); 7627935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert dayOfYear = getGregorianDayOfYear(); 7637935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert eyear = getGregorianYear(); 7647935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } else { 7657935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // The Julian epoch day (not the same as Julian Day) 7667935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // is zero on Saturday December 30, 0 (Gregorian). 7677935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert long julianEpochDay = julianDay - (JAN_1_1_JULIAN_DAY - 2); 7687935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert eyear = (int) floorDivide(4*julianEpochDay + 1464, 1461); 7697935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 7707935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // Compute the Julian calendar day number for January 1, eyear 7717935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert long january1 = 365*(eyear-1) + floorDivide(eyear-1, 4); 7727935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert dayOfYear = (int)(julianEpochDay - january1); // 0-based 7737935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 7747935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // Julian leap years occurred historically every 4 years starting 7757935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // with 8 AD. Before 8 AD the spacing is irregular; every 3 years 7767935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // from 45 BC to 9 BC, and then none until 8 AD. However, we don't 7777935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // implement this historical detail; instead, we implement the 7787935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // computatinally cleaner proleptic calendar, which assumes 7797935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // consistent 4-year cycles throughout time. 7807935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert boolean isLeap = ((eyear&0x3) == 0); // equiv. to (eyear%4 == 0) 7817935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 7827935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // Common Julian/Gregorian calculation 7837935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int correction = 0; 7847935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int march1 = isLeap ? 60 : 59; // zero-based DOY for March 1 7857935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (dayOfYear >= march1) { 7867935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert correction = isLeap ? 1 : 2; 7877935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 7887935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert month = (12 * (dayOfYear + correction) + 6) / 367; // zero-based month 7897935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert dayOfMonth = dayOfYear - MONTH_COUNT[month][isLeap?3:2] + 1; // one-based DOM 7907935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert ++dayOfYear; 7917935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 7927935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert internalSet(MONTH, month); 7937935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert internalSet(DAY_OF_MONTH, dayOfMonth); 7947935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert internalSet(DAY_OF_YEAR, dayOfYear); 7957935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert internalSet(EXTENDED_YEAR, eyear); 7967935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int era = AD; 7977935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (eyear < 1) { 7987935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert era = BC; 7997935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert eyear = 1 - eyear; 8007935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 8017935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert internalSet(ERA, era); 8027935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert internalSet(YEAR, eyear); 8037935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 8047935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 8057935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert///////////////////////////// 8067935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert// Fields => Time computation 8077935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert///////////////////////////// 8087935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 8097935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 8107935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 8117935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 8127935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert protected int handleGetExtendedYear() { 8137935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int year; 8147935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (newerField(EXTENDED_YEAR, YEAR) == EXTENDED_YEAR) { 8157935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert year = internalGet(EXTENDED_YEAR, EPOCH_YEAR); 8167935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } else { 8177935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // The year defaults to the epoch start, the era to AD 8187935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int era = internalGet(ERA, AD); 8197935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (era == BC) { 8207935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert year = 1 - internalGet(YEAR, 1); // Convert to extended year 8217935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } else { 8227935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert year = internalGet(YEAR, EPOCH_YEAR); 8237935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 8247935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 8257935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return year; 8267935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 8277935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 8287935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 8297935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 8307935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 8317935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert protected int handleComputeJulianDay(int bestField) { 8327935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 8337935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert invertGregorian = false; 8347935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 8357935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int jd = super.handleComputeJulianDay(bestField); 8367935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 8377935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // The following check handles portions of the cutover year BEFORE the 8387935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // cutover itself happens. 8397935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (isGregorian != (jd >= cutoverJulianDay)) { 8407935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert invertGregorian = true; 8417935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert jd = super.handleComputeJulianDay(bestField); 8427935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 8437935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 8447935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return jd; 8457935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 8467935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 8477935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 8487935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * Return JD of start of given month/year 8497935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 2.0 8507935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 8517935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert protected int handleComputeMonthStart(int eyear, int month, boolean useMonth) { 8527935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 8537935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // If the month is out of range, adjust it into range, and 8547935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // modify the extended year value accordingly. 8557935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (month < 0 || month > 11) { 8567935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int[] rem = new int[1]; 8577935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert eyear += floorDivide(month, 12, rem); 8587935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert month = rem[0]; 8597935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 8607935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 8617935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert boolean isLeap = eyear%4 == 0; 8627935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int y = eyear - 1; 8637935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert int julianDay = 365*y + floorDivide(y, 4) + (JAN_1_1_JULIAN_DAY - 3); 8647935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 8657935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert isGregorian = (eyear >= gregorianCutoverYear); 8667935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (invertGregorian) { 8677935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert isGregorian = !isGregorian; 8687935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 8697935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (isGregorian) { 8707935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert isLeap = isLeap && ((eyear%100 != 0) || (eyear%400 == 0)); 8717935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // Add 2 because Gregorian calendar starts 2 days after 8727935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // Julian calendar 8737935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert julianDay += floorDivide(y, 400) - floorDivide(y, 100) + 2; 8747935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 8757935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 8767935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // At this point julianDay indicates the day BEFORE the first 8777935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // day of January 1, <eyear> of either the Julian or Gregorian 8787935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert // calendar. 8797935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 8807935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (month != 0) { 8817935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert julianDay += MONTH_COUNT[month][isLeap?3:2]; 8827935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 8837935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 8847935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return julianDay; 8857935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 8867935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 8877935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /** 8887935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * {@inheritDoc} 8897935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert * @stable ICU 3.8 8907935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 8917935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public String getType() { 8927935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return "gregorian"; 8937935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 8947935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 8957935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert /* 8967935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert private static CalendarFactory factory; 8977935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public static CalendarFactory factory() { 8987935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert if (factory == null) { 8997935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert factory = new CalendarFactory() { 9007935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public Calendar create(TimeZone tz, ULocale loc) { 9017935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return new GregorianCalendar(tz, loc); 9027935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 9037935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert 9047935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert public String factoryName() { 9057935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return "Gregorian"; 9067935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 9077935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert }; 9087935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 9097935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert return factory; 9107935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert } 9117935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert */ 9127935b1839a081ed19ae0d33029ad3c09632a2caaFredrik Roubert} 913