1 /* 2 * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package java.util; 27 28 import java.io.IOException; 29 import java.io.ObjectInputStream; 30 import sun.util.locale.provider.CalendarDataUtility; 31 import sun.util.calendar.BaseCalendar; 32 import sun.util.calendar.CalendarDate; 33 import sun.util.calendar.CalendarSystem; 34 import sun.util.calendar.CalendarUtils; 35 import sun.util.calendar.Era; 36 import sun.util.calendar.Gregorian; 37 import sun.util.calendar.LocalGregorianCalendar; 38 import sun.util.calendar.ZoneInfo; 39 40 /** 41 * <code>JapaneseImperialCalendar</code> implements a Japanese 42 * calendar system in which the imperial era-based year numbering is 43 * supported from the Meiji era. The following are the eras supported 44 * by this calendar system. 45 * <pre><tt> 46 * ERA value Era name Since (in Gregorian) 47 * ------------------------------------------------------ 48 * 0 N/A N/A 49 * 1 Meiji 1868-01-01 midnight local time 50 * 2 Taisho 1912-07-30 midnight local time 51 * 3 Showa 1926-12-25 midnight local time 52 * 4 Heisei 1989-01-08 midnight local time 53 * ------------------------------------------------------ 54 * </tt></pre> 55 * 56 * <p><code>ERA</code> value 0 specifies the years before Meiji and 57 * the Gregorian year values are used. Unlike {@link 58 * GregorianCalendar}, the Julian to Gregorian transition is not 59 * supported because it doesn't make any sense to the Japanese 60 * calendar systems used before Meiji. To represent the years before 61 * Gregorian year 1, 0 and negative values are used. The Japanese 62 * Imperial rescripts and government decrees don't specify how to deal 63 * with time differences for applying the era transitions. This 64 * calendar implementation assumes local time for all transitions. 65 * 66 * @author Masayoshi Okutsu 67 * @since 1.6 68 */ 69 class JapaneseImperialCalendar extends Calendar { 70 /* 71 * Implementation Notes 72 * 73 * This implementation uses 74 * sun.util.calendar.LocalGregorianCalendar to perform most of the 75 * calendar calculations. LocalGregorianCalendar is configurable 76 * and reads <JRE_HOME>/lib/calendars.properties at the start-up. 77 */ 78 79 /** 80 * The ERA constant designating the era before Meiji. 81 */ 82 public static final int BEFORE_MEIJI = 0; 83 84 /** 85 * The ERA constant designating the Meiji era. 86 */ 87 public static final int MEIJI = 1; 88 89 /** 90 * The ERA constant designating the Taisho era. 91 */ 92 public static final int TAISHO = 2; 93 94 /** 95 * The ERA constant designating the Showa era. 96 */ 97 public static final int SHOWA = 3; 98 99 /** 100 * The ERA constant designating the Heisei era. 101 */ 102 public static final int HEISEI = 4; 103 104 private static final int EPOCH_OFFSET = 719163; // Fixed date of January 1, 1970 (Gregorian) 105 private static final int EPOCH_YEAR = 1970; 106 107 // Useful millisecond constants. Although ONE_DAY and ONE_WEEK can fit 108 // into ints, they must be longs in order to prevent arithmetic overflow 109 // when performing (bug 4173516). 110 private static final int ONE_SECOND = 1000; 111 private static final int ONE_MINUTE = 60*ONE_SECOND; 112 private static final int ONE_HOUR = 60*ONE_MINUTE; 113 private static final long ONE_DAY = 24*ONE_HOUR; 114 private static final long ONE_WEEK = 7*ONE_DAY; 115 116 // Reference to the sun.util.calendar.LocalGregorianCalendar instance (singleton). 117 private static final LocalGregorianCalendar jcal 118 = (LocalGregorianCalendar) CalendarSystem.forName("japanese"); 119 120 // Gregorian calendar instance. This is required because era 121 // transition dates are given in Gregorian dates. 122 private static final Gregorian gcal = CalendarSystem.getGregorianCalendar(); 123 124 // The Era instance representing "before Meiji". 125 private static final Era BEFORE_MEIJI_ERA = new Era("BeforeMeiji", "BM", Long.MIN_VALUE, false); 126 127 // Imperial eras. The sun.util.calendar.LocalGregorianCalendar 128 // doesn't have an Era representing before Meiji, which is 129 // inconvenient for a Calendar. So, era[0] is a reference to 130 // BEFORE_MEIJI_ERA. 131 private static final Era[] eras; 132 133 // Fixed date of the first date of each era. 134 private static final long[] sinceFixedDates; 135 136 /* 137 * <pre> 138 * Greatest Least 139 * Field name Minimum Minimum Maximum Maximum 140 * ---------- ------- ------- ------- ------- 141 * ERA 0 0 1 1 142 * YEAR -292275055 1 ? ? 143 * MONTH 0 0 11 11 144 * WEEK_OF_YEAR 1 1 52* 53 145 * WEEK_OF_MONTH 0 0 4* 6 146 * DAY_OF_MONTH 1 1 28* 31 147 * DAY_OF_YEAR 1 1 365* 366 148 * DAY_OF_WEEK 1 1 7 7 149 * DAY_OF_WEEK_IN_MONTH -1 -1 4* 6 150 * AM_PM 0 0 1 1 151 * HOUR 0 0 11 11 152 * HOUR_OF_DAY 0 0 23 23 153 * MINUTE 0 0 59 59 154 * SECOND 0 0 59 59 155 * MILLISECOND 0 0 999 999 156 * ZONE_OFFSET -13:00 -13:00 14:00 14:00 157 * DST_OFFSET 0:00 0:00 0:20 2:00 158 * </pre> 159 * *: depends on eras 160 */ 161 static final int MIN_VALUES[] = { 162 0, // ERA 163 -292275055, // YEAR 164 JANUARY, // MONTH 165 1, // WEEK_OF_YEAR 166 0, // WEEK_OF_MONTH 167 1, // DAY_OF_MONTH 168 1, // DAY_OF_YEAR 169 SUNDAY, // DAY_OF_WEEK 170 1, // DAY_OF_WEEK_IN_MONTH 171 AM, // AM_PM 172 0, // HOUR 173 0, // HOUR_OF_DAY 174 0, // MINUTE 175 0, // SECOND 176 0, // MILLISECOND 177 -13*ONE_HOUR, // ZONE_OFFSET (UNIX compatibility) 178 0 // DST_OFFSET 179 }; 180 static final int LEAST_MAX_VALUES[] = { 181 0, // ERA (initialized later) 182 0, // YEAR (initialized later) 183 JANUARY, // MONTH (Showa 64 ended in January.) 184 0, // WEEK_OF_YEAR (Showa 1 has only 6 days which could be 0 weeks.) 185 4, // WEEK_OF_MONTH 186 28, // DAY_OF_MONTH 187 0, // DAY_OF_YEAR (initialized later) 188 SATURDAY, // DAY_OF_WEEK 189 4, // DAY_OF_WEEK_IN 190 PM, // AM_PM 191 11, // HOUR 192 23, // HOUR_OF_DAY 193 59, // MINUTE 194 59, // SECOND 195 999, // MILLISECOND 196 14*ONE_HOUR, // ZONE_OFFSET 197 20*ONE_MINUTE // DST_OFFSET (historical least maximum) 198 }; 199 static final int MAX_VALUES[] = { 200 0, // ERA 201 292278994, // YEAR 202 DECEMBER, // MONTH 203 53, // WEEK_OF_YEAR 204 6, // WEEK_OF_MONTH 205 31, // DAY_OF_MONTH 206 366, // DAY_OF_YEAR 207 SATURDAY, // DAY_OF_WEEK 208 6, // DAY_OF_WEEK_IN 209 PM, // AM_PM 210 11, // HOUR 211 23, // HOUR_OF_DAY 212 59, // MINUTE 213 59, // SECOND 214 999, // MILLISECOND 215 14*ONE_HOUR, // ZONE_OFFSET 216 2*ONE_HOUR // DST_OFFSET (double summer time) 217 }; 218 219 // Proclaim serialization compatibility with JDK 1.6 220 private static final long serialVersionUID = -3364572813905467929L; 221 222 static { 223 Era[] es = jcal.getEras(); 224 int length = es.length + 1; 225 eras = new Era[length]; 226 sinceFixedDates = new long[length]; 227 228 // eras[BEFORE_MEIJI] and sinceFixedDate[BEFORE_MEIJI] are the 229 // same as Gregorian. 230 int index = BEFORE_MEIJI; 231 sinceFixedDates[index] = gcal.getFixedDate(BEFORE_MEIJI_ERA.getSinceDate()); 232 eras[index++] = BEFORE_MEIJI_ERA; 233 for (Era e : es) { 234 CalendarDate d = e.getSinceDate(); 235 sinceFixedDates[index] = gcal.getFixedDate(d); 236 eras[index++] = e; 237 } 238 239 LEAST_MAX_VALUES[ERA] = MAX_VALUES[ERA] = eras.length - 1; 240 241 // Calculate the least maximum year and least day of Year 242 // values. The following code assumes that there's at most one 243 // era transition in a Gregorian year. 244 int year = Integer.MAX_VALUE; 245 int dayOfYear = Integer.MAX_VALUE; 246 CalendarDate date = gcal.newCalendarDate(TimeZone.NO_TIMEZONE); 247 for (int i = 1; i < eras.length; i++) { 248 long fd = sinceFixedDates[i]; 249 CalendarDate transitionDate = eras[i].getSinceDate(); 250 date.setDate(transitionDate.getYear(), BaseCalendar.JANUARY, 1); 251 long fdd = gcal.getFixedDate(date); 252 if (fd != fdd) { 253 dayOfYear = Math.min((int)(fd - fdd) + 1, dayOfYear); 254 } 255 date.setDate(transitionDate.getYear(), BaseCalendar.DECEMBER, 31); 256 fdd = gcal.getFixedDate(date); 257 if (fd != fdd) { 258 dayOfYear = Math.min((int)(fdd - fd) + 1, dayOfYear); 259 } 260 LocalGregorianCalendar.Date lgd = getCalendarDate(fd - 1); 261 int y = lgd.getYear(); 262 // Unless the first year starts from January 1, the actual 263 // max value could be one year short. For example, if it's 264 // Showa 63 January 8, 63 is the actual max value since 265 // Showa 64 January 8 doesn't exist. 266 if (!(lgd.getMonth() == BaseCalendar.JANUARY && lgd.getDayOfMonth() == 1)) { 267 y--; 268 } 269 year = Math.min(y, year); 270 } 271 LEAST_MAX_VALUES[YEAR] = year; // Max year could be smaller than this value. 272 LEAST_MAX_VALUES[DAY_OF_YEAR] = dayOfYear; 273 } 274 275 /** 276 * jdate always has a sun.util.calendar.LocalGregorianCalendar.Date instance to 277 * avoid overhead of creating it for each calculation. 278 */ 279 private transient LocalGregorianCalendar.Date jdate; 280 281 /** 282 * Temporary int[2] to get time zone offsets. zoneOffsets[0] gets 283 * the GMT offset value and zoneOffsets[1] gets the daylight saving 284 * value. 285 */ 286 private transient int[] zoneOffsets; 287 288 /** 289 * Temporary storage for saving original fields[] values in 290 * non-lenient mode. 291 */ 292 private transient int[] originalFields; 293 294 /** 295 * Constructs a <code>JapaneseImperialCalendar</code> based on the current time 296 * in the given time zone with the given locale. 297 * 298 * @param zone the given time zone. 299 * @param aLocale the given locale. 300 */ 301 JapaneseImperialCalendar(TimeZone zone, Locale aLocale) { 302 super(zone, aLocale); 303 jdate = jcal.newCalendarDate(zone); 304 setTimeInMillis(System.currentTimeMillis()); 305 } 306 307 /** 308 * Constructs an "empty" {@code JapaneseImperialCalendar}. 309 * 310 * @param zone the given time zone 311 * @param aLocale the given locale 312 * @param flag the flag requesting an empty instance 313 */ 314 JapaneseImperialCalendar(TimeZone zone, Locale aLocale, boolean flag) { 315 super(zone, aLocale); 316 jdate = jcal.newCalendarDate(zone); 317 } 318 319 /** 320 * Returns {@code "japanese"} as the calendar type of this {@code 321 * JapaneseImperialCalendar}. 322 * 323 * @return {@code "japanese"} 324 */ 325 @Override 326 public String getCalendarType() { 327 return "japanese"; 328 } 329 330 /** 331 * Compares this <code>JapaneseImperialCalendar</code> to the specified 332 * <code>Object</code>. The result is <code>true</code> if and 333 * only if the argument is a <code>JapaneseImperialCalendar</code> object 334 * that represents the same time value (millisecond offset from 335 * the <a href="Calendar.html#Epoch">Epoch</a>) under the same 336 * <code>Calendar</code> parameters. 337 * 338 * @param obj the object to compare with. 339 * @return <code>true</code> if this object is equal to <code>obj</code>; 340 * <code>false</code> otherwise. 341 * @see Calendar#compareTo(Calendar) 342 */ 343 public boolean equals(Object obj) { 344 return obj instanceof JapaneseImperialCalendar && 345 super.equals(obj); 346 } 347 348 /** 349 * Generates the hash code for this 350 * <code>JapaneseImperialCalendar</code> object. 351 */ 352 public int hashCode() { 353 return super.hashCode() ^ jdate.hashCode(); 354 } 355 356 /** 357 * Adds the specified (signed) amount of time to the given calendar field, 358 * based on the calendar's rules. 359 * 360 * <p><em>Add rule 1</em>. The value of <code>field</code> 361 * after the call minus the value of <code>field</code> before the 362 * call is <code>amount</code>, modulo any overflow that has occurred in 363 * <code>field</code>. Overflow occurs when a field value exceeds its 364 * range and, as a result, the next larger field is incremented or 365 * decremented and the field value is adjusted back into its range.</p> 366 * 367 * <p><em>Add rule 2</em>. If a smaller field is expected to be 368 * invariant, but it is impossible for it to be equal to its 369 * prior value because of changes in its minimum or maximum after 370 * <code>field</code> is changed, then its value is adjusted to be as close 371 * as possible to its expected value. A smaller field represents a 372 * smaller unit of time. <code>HOUR</code> is a smaller field than 373 * <code>DAY_OF_MONTH</code>. No adjustment is made to smaller fields 374 * that are not expected to be invariant. The calendar system 375 * determines what fields are expected to be invariant.</p> 376 * 377 * @param field the calendar field. 378 * @param amount the amount of date or time to be added to the field. 379 * @exception IllegalArgumentException if <code>field</code> is 380 * <code>ZONE_OFFSET</code>, <code>DST_OFFSET</code>, or unknown, 381 * or if any calendar fields have out-of-range values in 382 * non-lenient mode. 383 */ 384 public void add(int field, int amount) { 385 // If amount == 0, do nothing even the given field is out of 386 // range. This is tested by JCK. 387 if (amount == 0) { 388 return; // Do nothing! 389 } 390 391 if (field < 0 || field >= ZONE_OFFSET) { 392 throw new IllegalArgumentException(); 393 } 394 395 // Sync the time and calendar fields. 396 complete(); 397 398 if (field == YEAR) { 399 LocalGregorianCalendar.Date d = (LocalGregorianCalendar.Date) jdate.clone(); 400 d.addYear(amount); 401 pinDayOfMonth(d); 402 set(ERA, getEraIndex(d)); 403 set(YEAR, d.getYear()); 404 set(MONTH, d.getMonth() - 1); 405 set(DAY_OF_MONTH, d.getDayOfMonth()); 406 } else if (field == MONTH) { 407 LocalGregorianCalendar.Date d = (LocalGregorianCalendar.Date) jdate.clone(); 408 d.addMonth(amount); 409 pinDayOfMonth(d); 410 set(ERA, getEraIndex(d)); 411 set(YEAR, d.getYear()); 412 set(MONTH, d.getMonth() - 1); 413 set(DAY_OF_MONTH, d.getDayOfMonth()); 414 } else if (field == ERA) { 415 int era = internalGet(ERA) + amount; 416 if (era < 0) { 417 era = 0; 418 } else if (era > eras.length - 1) { 419 era = eras.length - 1; 420 } 421 set(ERA, era); 422 } else { 423 long delta = amount; 424 long timeOfDay = 0; 425 switch (field) { 426 // Handle the time fields here. Convert the given 427 // amount to milliseconds and call setTimeInMillis. 428 case HOUR: 429 case HOUR_OF_DAY: 430 delta *= 60 * 60 * 1000; // hours to milliseconds 431 break; 432 433 case MINUTE: 434 delta *= 60 * 1000; // minutes to milliseconds 435 break; 436 437 case SECOND: 438 delta *= 1000; // seconds to milliseconds 439 break; 440 441 case MILLISECOND: 442 break; 443 444 // Handle week, day and AM_PM fields which involves 445 // time zone offset change adjustment. Convert the 446 // given amount to the number of days. 447 case WEEK_OF_YEAR: 448 case WEEK_OF_MONTH: 449 case DAY_OF_WEEK_IN_MONTH: 450 delta *= 7; 451 break; 452 453 case DAY_OF_MONTH: // synonym of DATE 454 case DAY_OF_YEAR: 455 case DAY_OF_WEEK: 456 break; 457 458 case AM_PM: 459 // Convert the amount to the number of days (delta) 460 // and +12 or -12 hours (timeOfDay). 461 delta = amount / 2; 462 timeOfDay = 12 * (amount % 2); 463 break; 464 } 465 466 // The time fields don't require time zone offset change 467 // adjustment. 468 if (field >= HOUR) { 469 setTimeInMillis(time + delta); 470 return; 471 } 472 473 // The rest of the fields (week, day or AM_PM fields) 474 // require time zone offset (both GMT and DST) change 475 // adjustment. 476 477 // Translate the current time to the fixed date and time 478 // of the day. 479 long fd = cachedFixedDate; 480 timeOfDay += internalGet(HOUR_OF_DAY); 481 timeOfDay *= 60; 482 timeOfDay += internalGet(MINUTE); 483 timeOfDay *= 60; 484 timeOfDay += internalGet(SECOND); 485 timeOfDay *= 1000; 486 timeOfDay += internalGet(MILLISECOND); 487 if (timeOfDay >= ONE_DAY) { 488 fd++; 489 timeOfDay -= ONE_DAY; 490 } else if (timeOfDay < 0) { 491 fd--; 492 timeOfDay += ONE_DAY; 493 } 494 495 fd += delta; // fd is the expected fixed date after the calculation 496 int zoneOffset = internalGet(ZONE_OFFSET) + internalGet(DST_OFFSET); 497 setTimeInMillis((fd - EPOCH_OFFSET) * ONE_DAY + timeOfDay - zoneOffset); 498 zoneOffset -= internalGet(ZONE_OFFSET) + internalGet(DST_OFFSET); 499 // If the time zone offset has changed, then adjust the difference. 500 if (zoneOffset != 0) { 501 setTimeInMillis(time + zoneOffset); 502 long fd2 = cachedFixedDate; 503 // If the adjustment has changed the date, then take 504 // the previous one. 505 if (fd2 != fd) { 506 setTimeInMillis(time - zoneOffset); 507 } 508 } 509 } 510 } 511 512 public void roll(int field, boolean up) { 513 roll(field, up ? +1 : -1); 514 } 515 516 /** 517 * Adds a signed amount to the specified calendar field without changing larger fields. 518 * A negative roll amount means to subtract from field without changing 519 * larger fields. If the specified amount is 0, this method performs nothing. 520 * 521 * <p>This method calls {@link #complete()} before adding the 522 * amount so that all the calendar fields are normalized. If there 523 * is any calendar field having an out-of-range value in non-lenient mode, then an 524 * <code>IllegalArgumentException</code> is thrown. 525 * 526 * @param field the calendar field. 527 * @param amount the signed amount to add to <code>field</code>. 528 * @exception IllegalArgumentException if <code>field</code> is 529 * <code>ZONE_OFFSET</code>, <code>DST_OFFSET</code>, or unknown, 530 * or if any calendar fields have out-of-range values in 531 * non-lenient mode. 532 * @see #roll(int,boolean) 533 * @see #add(int,int) 534 * @see #set(int,int) 535 */ 536 public void roll(int field, int amount) { 537 // If amount == 0, do nothing even the given field is out of 538 // range. This is tested by JCK. 539 if (amount == 0) { 540 return; 541 } 542 543 if (field < 0 || field >= ZONE_OFFSET) { 544 throw new IllegalArgumentException(); 545 } 546 547 // Sync the time and calendar fields. 548 complete(); 549 550 int min = getMinimum(field); 551 int max = getMaximum(field); 552 553 switch (field) { 554 case ERA: 555 case AM_PM: 556 case MINUTE: 557 case SECOND: 558 case MILLISECOND: 559 // These fields are handled simply, since they have fixed 560 // minima and maxima. Other fields are complicated, since 561 // the range within they must roll varies depending on the 562 // date, a time zone and the era transitions. 563 break; 564 565 case HOUR: 566 case HOUR_OF_DAY: 567 { 568 int unit = max + 1; // 12 or 24 hours 569 int h = internalGet(field); 570 int nh = (h + amount) % unit; 571 if (nh < 0) { 572 nh += unit; 573 } 574 time += ONE_HOUR * (nh - h); 575 576 // The day might have changed, which could happen if 577 // the daylight saving time transition brings it to 578 // the next day, although it's very unlikely. But we 579 // have to make sure not to change the larger fields. 580 CalendarDate d = jcal.getCalendarDate(time, getZone()); 581 if (internalGet(DAY_OF_MONTH) != d.getDayOfMonth()) { 582 d.setEra(jdate.getEra()); 583 d.setDate(internalGet(YEAR), 584 internalGet(MONTH) + 1, 585 internalGet(DAY_OF_MONTH)); 586 if (field == HOUR) { 587 assert (internalGet(AM_PM) == PM); 588 d.addHours(+12); // restore PM 589 } 590 time = jcal.getTime(d); 591 } 592 int hourOfDay = d.getHours(); 593 internalSet(field, hourOfDay % unit); 594 if (field == HOUR) { 595 internalSet(HOUR_OF_DAY, hourOfDay); 596 } else { 597 internalSet(AM_PM, hourOfDay / 12); 598 internalSet(HOUR, hourOfDay % 12); 599 } 600 601 // Time zone offset and/or daylight saving might have changed. 602 int zoneOffset = d.getZoneOffset(); 603 int saving = d.getDaylightSaving(); 604 internalSet(ZONE_OFFSET, zoneOffset - saving); 605 internalSet(DST_OFFSET, saving); 606 return; 607 } 608 609 case YEAR: 610 min = getActualMinimum(field); 611 max = getActualMaximum(field); 612 break; 613 614 case MONTH: 615 // Rolling the month involves both pinning the final value to [0, 11] 616 // and adjusting the DAY_OF_MONTH if necessary. We only adjust the 617 // DAY_OF_MONTH if, after updating the MONTH field, it is illegal. 618 // E.g., <jan31>.roll(MONTH, 1) -> <feb28> or <feb29>. 619 { 620 if (!isTransitionYear(jdate.getNormalizedYear())) { 621 int year = jdate.getYear(); 622 if (year == getMaximum(YEAR)) { 623 CalendarDate jd = jcal.getCalendarDate(time, getZone()); 624 CalendarDate d = jcal.getCalendarDate(Long.MAX_VALUE, getZone()); 625 max = d.getMonth() - 1; 626 int n = getRolledValue(internalGet(field), amount, min, max); 627 if (n == max) { 628 // To avoid overflow, use an equivalent year. 629 jd.addYear(-400); 630 jd.setMonth(n + 1); 631 if (jd.getDayOfMonth() > d.getDayOfMonth()) { 632 jd.setDayOfMonth(d.getDayOfMonth()); 633 jcal.normalize(jd); 634 } 635 if (jd.getDayOfMonth() == d.getDayOfMonth() 636 && jd.getTimeOfDay() > d.getTimeOfDay()) { 637 jd.setMonth(n + 1); 638 jd.setDayOfMonth(d.getDayOfMonth() - 1); 639 jcal.normalize(jd); 640 // Month may have changed by the normalization. 641 n = jd.getMonth() - 1; 642 } 643 set(DAY_OF_MONTH, jd.getDayOfMonth()); 644 } 645 set(MONTH, n); 646 } else if (year == getMinimum(YEAR)) { 647 CalendarDate jd = jcal.getCalendarDate(time, getZone()); 648 CalendarDate d = jcal.getCalendarDate(Long.MIN_VALUE, getZone()); 649 min = d.getMonth() - 1; 650 int n = getRolledValue(internalGet(field), amount, min, max); 651 if (n == min) { 652 // To avoid underflow, use an equivalent year. 653 jd.addYear(+400); 654 jd.setMonth(n + 1); 655 if (jd.getDayOfMonth() < d.getDayOfMonth()) { 656 jd.setDayOfMonth(d.getDayOfMonth()); 657 jcal.normalize(jd); 658 } 659 if (jd.getDayOfMonth() == d.getDayOfMonth() 660 && jd.getTimeOfDay() < d.getTimeOfDay()) { 661 jd.setMonth(n + 1); 662 jd.setDayOfMonth(d.getDayOfMonth() + 1); 663 jcal.normalize(jd); 664 // Month may have changed by the normalization. 665 n = jd.getMonth() - 1; 666 } 667 set(DAY_OF_MONTH, jd.getDayOfMonth()); 668 } 669 set(MONTH, n); 670 } else { 671 int mon = (internalGet(MONTH) + amount) % 12; 672 if (mon < 0) { 673 mon += 12; 674 } 675 set(MONTH, mon); 676 677 // Keep the day of month in the range. We 678 // don't want to spill over into the next 679 // month; e.g., we don't want jan31 + 1 mo -> 680 // feb31 -> mar3. 681 int monthLen = monthLength(mon); 682 if (internalGet(DAY_OF_MONTH) > monthLen) { 683 set(DAY_OF_MONTH, monthLen); 684 } 685 } 686 } else { 687 int eraIndex = getEraIndex(jdate); 688 CalendarDate transition = null; 689 if (jdate.getYear() == 1) { 690 transition = eras[eraIndex].getSinceDate(); 691 min = transition.getMonth() - 1; 692 } else { 693 if (eraIndex < eras.length - 1) { 694 transition = eras[eraIndex + 1].getSinceDate(); 695 if (transition.getYear() == jdate.getNormalizedYear()) { 696 max = transition.getMonth() - 1; 697 if (transition.getDayOfMonth() == 1) { 698 max--; 699 } 700 } 701 } 702 } 703 704 if (min == max) { 705 // The year has only one month. No need to 706 // process further. (Showa Gan-nen (year 1) 707 // and the last year have only one month.) 708 return; 709 } 710 int n = getRolledValue(internalGet(field), amount, min, max); 711 set(MONTH, n); 712 if (n == min) { 713 if (!(transition.getMonth() == BaseCalendar.JANUARY 714 && transition.getDayOfMonth() == 1)) { 715 if (jdate.getDayOfMonth() < transition.getDayOfMonth()) { 716 set(DAY_OF_MONTH, transition.getDayOfMonth()); 717 } 718 } 719 } else if (n == max && (transition.getMonth() - 1 == n)) { 720 int dom = transition.getDayOfMonth(); 721 if (jdate.getDayOfMonth() >= dom) { 722 set(DAY_OF_MONTH, dom - 1); 723 } 724 } 725 } 726 return; 727 } 728 729 case WEEK_OF_YEAR: 730 { 731 int y = jdate.getNormalizedYear(); 732 max = getActualMaximum(WEEK_OF_YEAR); 733 set(DAY_OF_WEEK, internalGet(DAY_OF_WEEK)); // update stamp[field] 734 int woy = internalGet(WEEK_OF_YEAR); 735 int value = woy + amount; 736 if (!isTransitionYear(jdate.getNormalizedYear())) { 737 int year = jdate.getYear(); 738 if (year == getMaximum(YEAR)) { 739 max = getActualMaximum(WEEK_OF_YEAR); 740 } else if (year == getMinimum(YEAR)) { 741 min = getActualMinimum(WEEK_OF_YEAR); 742 max = getActualMaximum(WEEK_OF_YEAR); 743 if (value > min && value < max) { 744 set(WEEK_OF_YEAR, value); 745 return; 746 } 747 748 } 749 // If the new value is in between min and max 750 // (exclusive), then we can use the value. 751 if (value > min && value < max) { 752 set(WEEK_OF_YEAR, value); 753 return; 754 } 755 long fd = cachedFixedDate; 756 // Make sure that the min week has the current DAY_OF_WEEK 757 long day1 = fd - (7 * (woy - min)); 758 if (year != getMinimum(YEAR)) { 759 if (gcal.getYearFromFixedDate(day1) != y) { 760 min++; 761 } 762 } else { 763 CalendarDate d = jcal.getCalendarDate(Long.MIN_VALUE, getZone()); 764 if (day1 < jcal.getFixedDate(d)) { 765 min++; 766 } 767 } 768 769 // Make sure the same thing for the max week 770 fd += 7 * (max - internalGet(WEEK_OF_YEAR)); 771 if (gcal.getYearFromFixedDate(fd) != y) { 772 max--; 773 } 774 break; 775 } 776 777 // Handle transition here. 778 long fd = cachedFixedDate; 779 long day1 = fd - (7 * (woy - min)); 780 // Make sure that the min week has the current DAY_OF_WEEK 781 LocalGregorianCalendar.Date d = getCalendarDate(day1); 782 if (!(d.getEra() == jdate.getEra() && d.getYear() == jdate.getYear())) { 783 min++; 784 } 785 786 // Make sure the same thing for the max week 787 fd += 7 * (max - woy); 788 jcal.getCalendarDateFromFixedDate(d, fd); 789 if (!(d.getEra() == jdate.getEra() && d.getYear() == jdate.getYear())) { 790 max--; 791 } 792 // value: the new WEEK_OF_YEAR which must be converted 793 // to month and day of month. 794 value = getRolledValue(woy, amount, min, max) - 1; 795 d = getCalendarDate(day1 + value * 7); 796 set(MONTH, d.getMonth() - 1); 797 set(DAY_OF_MONTH, d.getDayOfMonth()); 798 return; 799 } 800 801 case WEEK_OF_MONTH: 802 { 803 boolean isTransitionYear = isTransitionYear(jdate.getNormalizedYear()); 804 // dow: relative day of week from the first day of week 805 int dow = internalGet(DAY_OF_WEEK) - getFirstDayOfWeek(); 806 if (dow < 0) { 807 dow += 7; 808 } 809 810 long fd = cachedFixedDate; 811 long month1; // fixed date of the first day (usually 1) of the month 812 int monthLength; // actual month length 813 if (isTransitionYear) { 814 month1 = getFixedDateMonth1(jdate, fd); 815 monthLength = actualMonthLength(); 816 } else { 817 month1 = fd - internalGet(DAY_OF_MONTH) + 1; 818 monthLength = jcal.getMonthLength(jdate); 819 } 820 821 // the first day of week of the month. 822 long monthDay1st = LocalGregorianCalendar.getDayOfWeekDateOnOrBefore(month1 + 6, 823 getFirstDayOfWeek()); 824 // if the week has enough days to form a week, the 825 // week starts from the previous month. 826 if ((int)(monthDay1st - month1) >= getMinimalDaysInFirstWeek()) { 827 monthDay1st -= 7; 828 } 829 max = getActualMaximum(field); 830 831 // value: the new WEEK_OF_MONTH value 832 int value = getRolledValue(internalGet(field), amount, 1, max) - 1; 833 834 // nfd: fixed date of the rolled date 835 long nfd = monthDay1st + value * 7 + dow; 836 837 // Unlike WEEK_OF_YEAR, we need to change day of week if the 838 // nfd is out of the month. 839 if (nfd < month1) { 840 nfd = month1; 841 } else if (nfd >= (month1 + monthLength)) { 842 nfd = month1 + monthLength - 1; 843 } 844 set(DAY_OF_MONTH, (int)(nfd - month1) + 1); 845 return; 846 } 847 848 case DAY_OF_MONTH: 849 { 850 if (!isTransitionYear(jdate.getNormalizedYear())) { 851 max = jcal.getMonthLength(jdate); 852 break; 853 } 854 855 // TODO: Need to change the spec to be usable DAY_OF_MONTH rolling... 856 857 // Transition handling. We can't change year and era 858 // values here due to the Calendar roll spec! 859 long month1 = getFixedDateMonth1(jdate, cachedFixedDate); 860 861 // It may not be a regular month. Convert the date and range to 862 // the relative values, perform the roll, and 863 // convert the result back to the rolled date. 864 int value = getRolledValue((int)(cachedFixedDate - month1), amount, 865 0, actualMonthLength() - 1); 866 LocalGregorianCalendar.Date d = getCalendarDate(month1 + value); 867 assert getEraIndex(d) == internalGetEra() 868 && d.getYear() == internalGet(YEAR) && d.getMonth()-1 == internalGet(MONTH); 869 set(DAY_OF_MONTH, d.getDayOfMonth()); 870 return; 871 } 872 873 case DAY_OF_YEAR: 874 { 875 max = getActualMaximum(field); 876 if (!isTransitionYear(jdate.getNormalizedYear())) { 877 break; 878 } 879 880 // Handle transition. We can't change year and era values 881 // here due to the Calendar roll spec. 882 int value = getRolledValue(internalGet(DAY_OF_YEAR), amount, min, max); 883 long jan0 = cachedFixedDate - internalGet(DAY_OF_YEAR); 884 LocalGregorianCalendar.Date d = getCalendarDate(jan0 + value); 885 assert getEraIndex(d) == internalGetEra() && d.getYear() == internalGet(YEAR); 886 set(MONTH, d.getMonth() - 1); 887 set(DAY_OF_MONTH, d.getDayOfMonth()); 888 return; 889 } 890 891 case DAY_OF_WEEK: 892 { 893 int normalizedYear = jdate.getNormalizedYear(); 894 if (!isTransitionYear(normalizedYear) && !isTransitionYear(normalizedYear - 1)) { 895 // If the week of year is in the same year, we can 896 // just change DAY_OF_WEEK. 897 int weekOfYear = internalGet(WEEK_OF_YEAR); 898 if (weekOfYear > 1 && weekOfYear < 52) { 899 set(WEEK_OF_YEAR, internalGet(WEEK_OF_YEAR)); 900 max = SATURDAY; 901 break; 902 } 903 } 904 905 // We need to handle it in a different way around year 906 // boundaries and in the transition year. Note that 907 // changing era and year values violates the roll 908 // rule: not changing larger calendar fields... 909 amount %= 7; 910 if (amount == 0) { 911 return; 912 } 913 long fd = cachedFixedDate; 914 long dowFirst = LocalGregorianCalendar.getDayOfWeekDateOnOrBefore(fd, getFirstDayOfWeek()); 915 fd += amount; 916 if (fd < dowFirst) { 917 fd += 7; 918 } else if (fd >= dowFirst + 7) { 919 fd -= 7; 920 } 921 LocalGregorianCalendar.Date d = getCalendarDate(fd); 922 set(ERA, getEraIndex(d)); 923 set(d.getYear(), d.getMonth() - 1, d.getDayOfMonth()); 924 return; 925 } 926 927 case DAY_OF_WEEK_IN_MONTH: 928 { 929 min = 1; // after having normalized, min should be 1. 930 if (!isTransitionYear(jdate.getNormalizedYear())) { 931 int dom = internalGet(DAY_OF_MONTH); 932 int monthLength = jcal.getMonthLength(jdate); 933 int lastDays = monthLength % 7; 934 max = monthLength / 7; 935 int x = (dom - 1) % 7; 936 if (x < lastDays) { 937 max++; 938 } 939 set(DAY_OF_WEEK, internalGet(DAY_OF_WEEK)); 940 break; 941 } 942 943 // Transition year handling. 944 long fd = cachedFixedDate; 945 long month1 = getFixedDateMonth1(jdate, fd); 946 int monthLength = actualMonthLength(); 947 int lastDays = monthLength % 7; 948 max = monthLength / 7; 949 int x = (int)(fd - month1) % 7; 950 if (x < lastDays) { 951 max++; 952 } 953 int value = getRolledValue(internalGet(field), amount, min, max) - 1; 954 fd = month1 + value * 7 + x; 955 LocalGregorianCalendar.Date d = getCalendarDate(fd); 956 set(DAY_OF_MONTH, d.getDayOfMonth()); 957 return; 958 } 959 } 960 961 set(field, getRolledValue(internalGet(field), amount, min, max)); 962 } 963 964 @Override 965 public String getDisplayName(int field, int style, Locale locale) { 966 if (!checkDisplayNameParams(field, style, SHORT, NARROW_FORMAT, locale, 967 ERA_MASK|YEAR_MASK|MONTH_MASK|DAY_OF_WEEK_MASK|AM_PM_MASK)) { 968 return null; 969 } 970 971 int fieldValue = get(field); 972 973 // "GanNen" is supported only in the LONG style. 974 if (field == YEAR 975 && (getBaseStyle(style) != LONG || fieldValue != 1 || get(ERA) == 0)) { 976 return null; 977 } 978 979 String name = CalendarDataUtility.retrieveFieldValueName(getCalendarType(), field, 980 fieldValue, style, locale); 981 // If the ERA value is null, then 982 // try to get its name or abbreviation from the Era instance. 983 if (name == null && field == ERA && fieldValue < eras.length) { 984 Era era = eras[fieldValue]; 985 name = (style == SHORT) ? era.getAbbreviation() : era.getName(); 986 } 987 return name; 988 } 989 990 @Override 991 public Map<String,Integer> getDisplayNames(int field, int style, Locale locale) { 992 if (!checkDisplayNameParams(field, style, ALL_STYLES, NARROW_FORMAT, locale, 993 ERA_MASK|YEAR_MASK|MONTH_MASK|DAY_OF_WEEK_MASK|AM_PM_MASK)) { 994 return null; 995 } 996 Map<String, Integer> names; 997 names = CalendarDataUtility.retrieveFieldValueNames(getCalendarType(), field, style, locale); 998 // If strings[] has fewer than eras[], get more names from eras[]. 999 if (names != null) { 1000 if (field == ERA) { 1001 int size = names.size(); 1002 if (style == ALL_STYLES) { 1003 Set<Integer> values = new HashSet<>(); 1004 // count unique era values 1005 for (String key : names.keySet()) { 1006 values.add(names.get(key)); 1007 } 1008 size = values.size(); 1009 } 1010 if (size < eras.length) { 1011 int baseStyle = getBaseStyle(style); 1012 for (int i = size; i < eras.length; i++) { 1013 Era era = eras[i]; 1014 if (baseStyle == ALL_STYLES || baseStyle == SHORT 1015 || baseStyle == NARROW_FORMAT) { 1016 names.put(era.getAbbreviation(), i); 1017 } 1018 if (baseStyle == ALL_STYLES || baseStyle == LONG) { 1019 names.put(era.getName(), i); 1020 } 1021 } 1022 } 1023 } 1024 } 1025 return names; 1026 } 1027 1028 /** 1029 * Returns the minimum value for the given calendar field of this 1030 * <code>Calendar</code> instance. The minimum value is 1031 * defined as the smallest value returned by the {@link 1032 * Calendar#get(int) get} method for any possible time value, 1033 * taking into consideration the current values of the 1034 * {@link Calendar#getFirstDayOfWeek() getFirstDayOfWeek}, 1035 * {@link Calendar#getMinimalDaysInFirstWeek() getMinimalDaysInFirstWeek}, 1036 * and {@link Calendar#getTimeZone() getTimeZone} methods. 1037 * 1038 * @param field the calendar field. 1039 * @return the minimum value for the given calendar field. 1040 * @see #getMaximum(int) 1041 * @see #getGreatestMinimum(int) 1042 * @see #getLeastMaximum(int) 1043 * @see #getActualMinimum(int) 1044 * @see #getActualMaximum(int) 1045 */ 1046 public int getMinimum(int field) { 1047 return MIN_VALUES[field]; 1048 } 1049 1050 /** 1051 * Returns the maximum value for the given calendar field of this 1052 * <code>GregorianCalendar</code> instance. The maximum value is 1053 * defined as the largest value returned by the {@link 1054 * Calendar#get(int) get} method for any possible time value, 1055 * taking into consideration the current values of the 1056 * {@link Calendar#getFirstDayOfWeek() getFirstDayOfWeek}, 1057 * {@link Calendar#getMinimalDaysInFirstWeek() getMinimalDaysInFirstWeek}, 1058 * and {@link Calendar#getTimeZone() getTimeZone} methods. 1059 * 1060 * @param field the calendar field. 1061 * @return the maximum value for the given calendar field. 1062 * @see #getMinimum(int) 1063 * @see #getGreatestMinimum(int) 1064 * @see #getLeastMaximum(int) 1065 * @see #getActualMinimum(int) 1066 * @see #getActualMaximum(int) 1067 */ 1068 public int getMaximum(int field) { 1069 switch (field) { 1070 case YEAR: 1071 { 1072 // The value should depend on the time zone of this calendar. 1073 LocalGregorianCalendar.Date d = jcal.getCalendarDate(Long.MAX_VALUE, 1074 getZone()); 1075 return Math.max(LEAST_MAX_VALUES[YEAR], d.getYear()); 1076 } 1077 } 1078 return MAX_VALUES[field]; 1079 } 1080 1081 /** 1082 * Returns the highest minimum value for the given calendar field 1083 * of this <code>GregorianCalendar</code> instance. The highest 1084 * minimum value is defined as the largest value returned by 1085 * {@link #getActualMinimum(int)} for any possible time value, 1086 * taking into consideration the current values of the 1087 * {@link Calendar#getFirstDayOfWeek() getFirstDayOfWeek}, 1088 * {@link Calendar#getMinimalDaysInFirstWeek() getMinimalDaysInFirstWeek}, 1089 * and {@link Calendar#getTimeZone() getTimeZone} methods. 1090 * 1091 * @param field the calendar field. 1092 * @return the highest minimum value for the given calendar field. 1093 * @see #getMinimum(int) 1094 * @see #getMaximum(int) 1095 * @see #getLeastMaximum(int) 1096 * @see #getActualMinimum(int) 1097 * @see #getActualMaximum(int) 1098 */ 1099 public int getGreatestMinimum(int field) { 1100 return field == YEAR ? 1 : MIN_VALUES[field]; 1101 } 1102 1103 /** 1104 * Returns the lowest maximum value for the given calendar field 1105 * of this <code>GregorianCalendar</code> instance. The lowest 1106 * maximum value is defined as the smallest value returned by 1107 * {@link #getActualMaximum(int)} for any possible time value, 1108 * taking into consideration the current values of the 1109 * {@link Calendar#getFirstDayOfWeek() getFirstDayOfWeek}, 1110 * {@link Calendar#getMinimalDaysInFirstWeek() getMinimalDaysInFirstWeek}, 1111 * and {@link Calendar#getTimeZone() getTimeZone} methods. 1112 * 1113 * @param field the calendar field 1114 * @return the lowest maximum value for the given calendar field. 1115 * @see #getMinimum(int) 1116 * @see #getMaximum(int) 1117 * @see #getGreatestMinimum(int) 1118 * @see #getActualMinimum(int) 1119 * @see #getActualMaximum(int) 1120 */ 1121 public int getLeastMaximum(int field) { 1122 switch (field) { 1123 case YEAR: 1124 { 1125 return Math.min(LEAST_MAX_VALUES[YEAR], getMaximum(YEAR)); 1126 } 1127 } 1128 return LEAST_MAX_VALUES[field]; 1129 } 1130 1131 /** 1132 * Returns the minimum value that this calendar field could have, 1133 * taking into consideration the given time value and the current 1134 * values of the 1135 * {@link Calendar#getFirstDayOfWeek() getFirstDayOfWeek}, 1136 * {@link Calendar#getMinimalDaysInFirstWeek() getMinimalDaysInFirstWeek}, 1137 * and {@link Calendar#getTimeZone() getTimeZone} methods. 1138 * 1139 * @param field the calendar field 1140 * @return the minimum of the given field for the time value of 1141 * this <code>JapaneseImperialCalendar</code> 1142 * @see #getMinimum(int) 1143 * @see #getMaximum(int) 1144 * @see #getGreatestMinimum(int) 1145 * @see #getLeastMaximum(int) 1146 * @see #getActualMaximum(int) 1147 */ 1148 public int getActualMinimum(int field) { 1149 if (!isFieldSet(YEAR_MASK|MONTH_MASK|WEEK_OF_YEAR_MASK, field)) { 1150 return getMinimum(field); 1151 } 1152 1153 int value = 0; 1154 JapaneseImperialCalendar jc = getNormalizedCalendar(); 1155 // Get a local date which includes time of day and time zone, 1156 // which are missing in jc.jdate. 1157 LocalGregorianCalendar.Date jd = jcal.getCalendarDate(jc.getTimeInMillis(), 1158 getZone()); 1159 int eraIndex = getEraIndex(jd); 1160 switch (field) { 1161 case YEAR: 1162 { 1163 if (eraIndex > BEFORE_MEIJI) { 1164 value = 1; 1165 long since = eras[eraIndex].getSince(getZone()); 1166 CalendarDate d = jcal.getCalendarDate(since, getZone()); 1167 // Use the same year in jd to take care of leap 1168 // years. i.e., both jd and d must agree on leap 1169 // or common years. 1170 jd.setYear(d.getYear()); 1171 jcal.normalize(jd); 1172 assert jd.isLeapYear() == d.isLeapYear(); 1173 if (getYearOffsetInMillis(jd) < getYearOffsetInMillis(d)) { 1174 value++; 1175 } 1176 } else { 1177 value = getMinimum(field); 1178 CalendarDate d = jcal.getCalendarDate(Long.MIN_VALUE, getZone()); 1179 // Use an equvalent year of d.getYear() if 1180 // possible. Otherwise, ignore the leap year and 1181 // common year difference. 1182 int y = d.getYear(); 1183 if (y > 400) { 1184 y -= 400; 1185 } 1186 jd.setYear(y); 1187 jcal.normalize(jd); 1188 if (getYearOffsetInMillis(jd) < getYearOffsetInMillis(d)) { 1189 value++; 1190 } 1191 } 1192 } 1193 break; 1194 1195 case MONTH: 1196 { 1197 // In Before Meiji and Meiji, January is the first month. 1198 if (eraIndex > MEIJI && jd.getYear() == 1) { 1199 long since = eras[eraIndex].getSince(getZone()); 1200 CalendarDate d = jcal.getCalendarDate(since, getZone()); 1201 value = d.getMonth() - 1; 1202 if (jd.getDayOfMonth() < d.getDayOfMonth()) { 1203 value++; 1204 } 1205 } 1206 } 1207 break; 1208 1209 case WEEK_OF_YEAR: 1210 { 1211 value = 1; 1212 CalendarDate d = jcal.getCalendarDate(Long.MIN_VALUE, getZone()); 1213 // shift 400 years to avoid underflow 1214 d.addYear(+400); 1215 jcal.normalize(d); 1216 jd.setEra(d.getEra()); 1217 jd.setYear(d.getYear()); 1218 jcal.normalize(jd); 1219 1220 long jan1 = jcal.getFixedDate(d); 1221 long fd = jcal.getFixedDate(jd); 1222 int woy = getWeekNumber(jan1, fd); 1223 long day1 = fd - (7 * (woy - 1)); 1224 if ((day1 < jan1) || 1225 (day1 == jan1 && 1226 jd.getTimeOfDay() < d.getTimeOfDay())) { 1227 value++; 1228 } 1229 } 1230 break; 1231 } 1232 return value; 1233 } 1234 1235 /** 1236 * Returns the maximum value that this calendar field could have, 1237 * taking into consideration the given time value and the current 1238 * values of the 1239 * {@link Calendar#getFirstDayOfWeek() getFirstDayOfWeek}, 1240 * {@link Calendar#getMinimalDaysInFirstWeek() getMinimalDaysInFirstWeek}, 1241 * and 1242 * {@link Calendar#getTimeZone() getTimeZone} methods. 1243 * For example, if the date of this instance is Heisei 16February 1, 1244 * the actual maximum value of the <code>DAY_OF_MONTH</code> field 1245 * is 29 because Heisei 16 is a leap year, and if the date of this 1246 * instance is Heisei 17 February 1, it's 28. 1247 * 1248 * @param field the calendar field 1249 * @return the maximum of the given field for the time value of 1250 * this <code>JapaneseImperialCalendar</code> 1251 * @see #getMinimum(int) 1252 * @see #getMaximum(int) 1253 * @see #getGreatestMinimum(int) 1254 * @see #getLeastMaximum(int) 1255 * @see #getActualMinimum(int) 1256 */ 1257 public int getActualMaximum(int field) { 1258 final int fieldsForFixedMax = ERA_MASK|DAY_OF_WEEK_MASK|HOUR_MASK|AM_PM_MASK| 1259 HOUR_OF_DAY_MASK|MINUTE_MASK|SECOND_MASK|MILLISECOND_MASK| 1260 ZONE_OFFSET_MASK|DST_OFFSET_MASK; 1261 if ((fieldsForFixedMax & (1<<field)) != 0) { 1262 return getMaximum(field); 1263 } 1264 1265 JapaneseImperialCalendar jc = getNormalizedCalendar(); 1266 LocalGregorianCalendar.Date date = jc.jdate; 1267 int normalizedYear = date.getNormalizedYear(); 1268 1269 int value = -1; 1270 switch (field) { 1271 case MONTH: 1272 { 1273 value = DECEMBER; 1274 if (isTransitionYear(date.getNormalizedYear())) { 1275 // TODO: there may be multiple transitions in a year. 1276 int eraIndex = getEraIndex(date); 1277 if (date.getYear() != 1) { 1278 eraIndex++; 1279 assert eraIndex < eras.length; 1280 } 1281 long transition = sinceFixedDates[eraIndex]; 1282 long fd = jc.cachedFixedDate; 1283 if (fd < transition) { 1284 LocalGregorianCalendar.Date ldate 1285 = (LocalGregorianCalendar.Date) date.clone(); 1286 jcal.getCalendarDateFromFixedDate(ldate, transition - 1); 1287 value = ldate.getMonth() - 1; 1288 } 1289 } else { 1290 LocalGregorianCalendar.Date d = jcal.getCalendarDate(Long.MAX_VALUE, 1291 getZone()); 1292 if (date.getEra() == d.getEra() && date.getYear() == d.getYear()) { 1293 value = d.getMonth() - 1; 1294 } 1295 } 1296 } 1297 break; 1298 1299 case DAY_OF_MONTH: 1300 value = jcal.getMonthLength(date); 1301 break; 1302 1303 case DAY_OF_YEAR: 1304 { 1305 if (isTransitionYear(date.getNormalizedYear())) { 1306 // Handle transition year. 1307 // TODO: there may be multiple transitions in a year. 1308 int eraIndex = getEraIndex(date); 1309 if (date.getYear() != 1) { 1310 eraIndex++; 1311 assert eraIndex < eras.length; 1312 } 1313 long transition = sinceFixedDates[eraIndex]; 1314 long fd = jc.cachedFixedDate; 1315 CalendarDate d = gcal.newCalendarDate(TimeZone.NO_TIMEZONE); 1316 d.setDate(date.getNormalizedYear(), BaseCalendar.JANUARY, 1); 1317 if (fd < transition) { 1318 value = (int)(transition - gcal.getFixedDate(d)); 1319 } else { 1320 d.addYear(+1); 1321 value = (int)(gcal.getFixedDate(d) - transition); 1322 } 1323 } else { 1324 LocalGregorianCalendar.Date d = jcal.getCalendarDate(Long.MAX_VALUE, 1325 getZone()); 1326 if (date.getEra() == d.getEra() && date.getYear() == d.getYear()) { 1327 long fd = jcal.getFixedDate(d); 1328 long jan1 = getFixedDateJan1(d, fd); 1329 value = (int)(fd - jan1) + 1; 1330 } else if (date.getYear() == getMinimum(YEAR)) { 1331 CalendarDate d1 = jcal.getCalendarDate(Long.MIN_VALUE, getZone()); 1332 long fd1 = jcal.getFixedDate(d1); 1333 d1.addYear(1); 1334 d1.setMonth(BaseCalendar.JANUARY).setDayOfMonth(1); 1335 jcal.normalize(d1); 1336 long fd2 = jcal.getFixedDate(d1); 1337 value = (int)(fd2 - fd1); 1338 } else { 1339 value = jcal.getYearLength(date); 1340 } 1341 } 1342 } 1343 break; 1344 1345 case WEEK_OF_YEAR: 1346 { 1347 if (!isTransitionYear(date.getNormalizedYear())) { 1348 LocalGregorianCalendar.Date jd = jcal.getCalendarDate(Long.MAX_VALUE, 1349 getZone()); 1350 if (date.getEra() == jd.getEra() && date.getYear() == jd.getYear()) { 1351 long fd = jcal.getFixedDate(jd); 1352 long jan1 = getFixedDateJan1(jd, fd); 1353 value = getWeekNumber(jan1, fd); 1354 } else if (date.getEra() == null && date.getYear() == getMinimum(YEAR)) { 1355 CalendarDate d = jcal.getCalendarDate(Long.MIN_VALUE, getZone()); 1356 // shift 400 years to avoid underflow 1357 d.addYear(+400); 1358 jcal.normalize(d); 1359 jd.setEra(d.getEra()); 1360 jd.setDate(d.getYear() + 1, BaseCalendar.JANUARY, 1); 1361 jcal.normalize(jd); 1362 long jan1 = jcal.getFixedDate(d); 1363 long nextJan1 = jcal.getFixedDate(jd); 1364 long nextJan1st = LocalGregorianCalendar.getDayOfWeekDateOnOrBefore(nextJan1 + 6, 1365 getFirstDayOfWeek()); 1366 int ndays = (int)(nextJan1st - nextJan1); 1367 if (ndays >= getMinimalDaysInFirstWeek()) { 1368 nextJan1st -= 7; 1369 } 1370 value = getWeekNumber(jan1, nextJan1st); 1371 } else { 1372 // Get the day of week of January 1 of the year 1373 CalendarDate d = gcal.newCalendarDate(TimeZone.NO_TIMEZONE); 1374 d.setDate(date.getNormalizedYear(), BaseCalendar.JANUARY, 1); 1375 int dayOfWeek = gcal.getDayOfWeek(d); 1376 // Normalize the day of week with the firstDayOfWeek value 1377 dayOfWeek -= getFirstDayOfWeek(); 1378 if (dayOfWeek < 0) { 1379 dayOfWeek += 7; 1380 } 1381 value = 52; 1382 int magic = dayOfWeek + getMinimalDaysInFirstWeek() - 1; 1383 if ((magic == 6) || 1384 (date.isLeapYear() && (magic == 5 || magic == 12))) { 1385 value++; 1386 } 1387 } 1388 break; 1389 } 1390 1391 if (jc == this) { 1392 jc = (JapaneseImperialCalendar) jc.clone(); 1393 } 1394 int max = getActualMaximum(DAY_OF_YEAR); 1395 jc.set(DAY_OF_YEAR, max); 1396 value = jc.get(WEEK_OF_YEAR); 1397 if (value == 1 && max > 7) { 1398 jc.add(WEEK_OF_YEAR, -1); 1399 value = jc.get(WEEK_OF_YEAR); 1400 } 1401 } 1402 break; 1403 1404 case WEEK_OF_MONTH: 1405 { 1406 LocalGregorianCalendar.Date jd = jcal.getCalendarDate(Long.MAX_VALUE, 1407 getZone()); 1408 if (!(date.getEra() == jd.getEra() && date.getYear() == jd.getYear())) { 1409 CalendarDate d = gcal.newCalendarDate(TimeZone.NO_TIMEZONE); 1410 d.setDate(date.getNormalizedYear(), date.getMonth(), 1); 1411 int dayOfWeek = gcal.getDayOfWeek(d); 1412 int monthLength = gcal.getMonthLength(d); 1413 dayOfWeek -= getFirstDayOfWeek(); 1414 if (dayOfWeek < 0) { 1415 dayOfWeek += 7; 1416 } 1417 int nDaysFirstWeek = 7 - dayOfWeek; // # of days in the first week 1418 value = 3; 1419 if (nDaysFirstWeek >= getMinimalDaysInFirstWeek()) { 1420 value++; 1421 } 1422 monthLength -= nDaysFirstWeek + 7 * 3; 1423 if (monthLength > 0) { 1424 value++; 1425 if (monthLength > 7) { 1426 value++; 1427 } 1428 } 1429 } else { 1430 long fd = jcal.getFixedDate(jd); 1431 long month1 = fd - jd.getDayOfMonth() + 1; 1432 value = getWeekNumber(month1, fd); 1433 } 1434 } 1435 break; 1436 1437 case DAY_OF_WEEK_IN_MONTH: 1438 { 1439 int ndays, dow1; 1440 int dow = date.getDayOfWeek(); 1441 BaseCalendar.Date d = (BaseCalendar.Date) date.clone(); 1442 ndays = jcal.getMonthLength(d); 1443 d.setDayOfMonth(1); 1444 jcal.normalize(d); 1445 dow1 = d.getDayOfWeek(); 1446 int x = dow - dow1; 1447 if (x < 0) { 1448 x += 7; 1449 } 1450 ndays -= x; 1451 value = (ndays + 6) / 7; 1452 } 1453 break; 1454 1455 case YEAR: 1456 { 1457 CalendarDate jd = jcal.getCalendarDate(jc.getTimeInMillis(), getZone()); 1458 CalendarDate d; 1459 int eraIndex = getEraIndex(date); 1460 if (eraIndex == eras.length - 1) { 1461 d = jcal.getCalendarDate(Long.MAX_VALUE, getZone()); 1462 value = d.getYear(); 1463 // Use an equivalent year for the 1464 // getYearOffsetInMillis call to avoid overflow. 1465 if (value > 400) { 1466 jd.setYear(value - 400); 1467 } 1468 } else { 1469 d = jcal.getCalendarDate(eras[eraIndex + 1].getSince(getZone()) - 1, 1470 getZone()); 1471 value = d.getYear(); 1472 // Use the same year as d.getYear() to be 1473 // consistent with leap and common years. 1474 jd.setYear(value); 1475 } 1476 jcal.normalize(jd); 1477 if (getYearOffsetInMillis(jd) > getYearOffsetInMillis(d)) { 1478 value--; 1479 } 1480 } 1481 break; 1482 1483 default: 1484 throw new ArrayIndexOutOfBoundsException(field); 1485 } 1486 return value; 1487 } 1488 1489 /** 1490 * Returns the millisecond offset from the beginning of the 1491 * year. In the year for Long.MIN_VALUE, it's a pseudo value 1492 * beyond the limit. The given CalendarDate object must have been 1493 * normalized before calling this method. 1494 */ 1495 private long getYearOffsetInMillis(CalendarDate date) { 1496 long t = (jcal.getDayOfYear(date) - 1) * ONE_DAY; 1497 return t + date.getTimeOfDay() - date.getZoneOffset(); 1498 } 1499 1500 public Object clone() { 1501 JapaneseImperialCalendar other = (JapaneseImperialCalendar) super.clone(); 1502 1503 other.jdate = (LocalGregorianCalendar.Date) jdate.clone(); 1504 other.originalFields = null; 1505 other.zoneOffsets = null; 1506 return other; 1507 } 1508 1509 public TimeZone getTimeZone() { 1510 TimeZone zone = super.getTimeZone(); 1511 // To share the zone by the CalendarDate 1512 jdate.setZone(zone); 1513 return zone; 1514 } 1515 1516 public void setTimeZone(TimeZone zone) { 1517 super.setTimeZone(zone); 1518 // To share the zone by the CalendarDate 1519 jdate.setZone(zone); 1520 } 1521 1522 /** 1523 * The fixed date corresponding to jdate. If the value is 1524 * Long.MIN_VALUE, the fixed date value is unknown. 1525 */ 1526 transient private long cachedFixedDate = Long.MIN_VALUE; 1527 1528 /** 1529 * Converts the time value (millisecond offset from the <a 1530 * href="Calendar.html#Epoch">Epoch</a>) to calendar field values. 1531 * The time is <em>not</em> 1532 * recomputed first; to recompute the time, then the fields, call the 1533 * <code>complete</code> method. 1534 * 1535 * @see Calendar#complete 1536 */ 1537 protected void computeFields() { 1538 int mask = 0; 1539 if (isPartiallyNormalized()) { 1540 // Determine which calendar fields need to be computed. 1541 mask = getSetStateFields(); 1542 int fieldMask = ~mask & ALL_FIELDS; 1543 if (fieldMask != 0 || cachedFixedDate == Long.MIN_VALUE) { 1544 mask |= computeFields(fieldMask, 1545 mask & (ZONE_OFFSET_MASK|DST_OFFSET_MASK)); 1546 assert mask == ALL_FIELDS; 1547 } 1548 } else { 1549 // Specify all fields 1550 mask = ALL_FIELDS; 1551 computeFields(mask, 0); 1552 } 1553 // After computing all the fields, set the field state to `COMPUTED'. 1554 setFieldsComputed(mask); 1555 } 1556 1557 /** 1558 * This computeFields implements the conversion from UTC 1559 * (millisecond offset from the Epoch) to calendar 1560 * field values. fieldMask specifies which fields to change the 1561 * setting state to COMPUTED, although all fields are set to 1562 * the correct values. This is required to fix 4685354. 1563 * 1564 * @param fieldMask a bit mask to specify which fields to change 1565 * the setting state. 1566 * @param tzMask a bit mask to specify which time zone offset 1567 * fields to be used for time calculations 1568 * @return a new field mask that indicates what field values have 1569 * actually been set. 1570 */ 1571 private int computeFields(int fieldMask, int tzMask) { 1572 int zoneOffset = 0; 1573 TimeZone tz = getZone(); 1574 if (zoneOffsets == null) { 1575 zoneOffsets = new int[2]; 1576 } 1577 if (tzMask != (ZONE_OFFSET_MASK|DST_OFFSET_MASK)) { 1578 if (tz instanceof ZoneInfo) { 1579 zoneOffset = ((ZoneInfo)tz).getOffsets(time, zoneOffsets); 1580 } else { 1581 zoneOffset = tz.getOffset(time); 1582 zoneOffsets[0] = tz.getRawOffset(); 1583 zoneOffsets[1] = zoneOffset - zoneOffsets[0]; 1584 } 1585 } 1586 if (tzMask != 0) { 1587 if (isFieldSet(tzMask, ZONE_OFFSET)) { 1588 zoneOffsets[0] = internalGet(ZONE_OFFSET); 1589 } 1590 if (isFieldSet(tzMask, DST_OFFSET)) { 1591 zoneOffsets[1] = internalGet(DST_OFFSET); 1592 } 1593 zoneOffset = zoneOffsets[0] + zoneOffsets[1]; 1594 } 1595 1596 // By computing time and zoneOffset separately, we can take 1597 // the wider range of time+zoneOffset than the previous 1598 // implementation. 1599 long fixedDate = zoneOffset / ONE_DAY; 1600 int timeOfDay = zoneOffset % (int)ONE_DAY; 1601 fixedDate += time / ONE_DAY; 1602 timeOfDay += (int) (time % ONE_DAY); 1603 if (timeOfDay >= ONE_DAY) { 1604 timeOfDay -= ONE_DAY; 1605 ++fixedDate; 1606 } else { 1607 while (timeOfDay < 0) { 1608 timeOfDay += ONE_DAY; 1609 --fixedDate; 1610 } 1611 } 1612 fixedDate += EPOCH_OFFSET; 1613 1614 // See if we can use jdate to avoid date calculation. 1615 if (fixedDate != cachedFixedDate || fixedDate < 0) { 1616 jcal.getCalendarDateFromFixedDate(jdate, fixedDate); 1617 cachedFixedDate = fixedDate; 1618 } 1619 int era = getEraIndex(jdate); 1620 int year = jdate.getYear(); 1621 1622 // Always set the ERA and YEAR values. 1623 internalSet(ERA, era); 1624 internalSet(YEAR, year); 1625 int mask = fieldMask | (ERA_MASK|YEAR_MASK); 1626 1627 int month = jdate.getMonth() - 1; // 0-based 1628 int dayOfMonth = jdate.getDayOfMonth(); 1629 1630 // Set the basic date fields. 1631 if ((fieldMask & (MONTH_MASK|DAY_OF_MONTH_MASK|DAY_OF_WEEK_MASK)) 1632 != 0) { 1633 internalSet(MONTH, month); 1634 internalSet(DAY_OF_MONTH, dayOfMonth); 1635 internalSet(DAY_OF_WEEK, jdate.getDayOfWeek()); 1636 mask |= MONTH_MASK|DAY_OF_MONTH_MASK|DAY_OF_WEEK_MASK; 1637 } 1638 1639 if ((fieldMask & (HOUR_OF_DAY_MASK|AM_PM_MASK|HOUR_MASK 1640 |MINUTE_MASK|SECOND_MASK|MILLISECOND_MASK)) != 0) { 1641 if (timeOfDay != 0) { 1642 int hours = timeOfDay / ONE_HOUR; 1643 internalSet(HOUR_OF_DAY, hours); 1644 internalSet(AM_PM, hours / 12); // Assume AM == 0 1645 internalSet(HOUR, hours % 12); 1646 int r = timeOfDay % ONE_HOUR; 1647 internalSet(MINUTE, r / ONE_MINUTE); 1648 r %= ONE_MINUTE; 1649 internalSet(SECOND, r / ONE_SECOND); 1650 internalSet(MILLISECOND, r % ONE_SECOND); 1651 } else { 1652 internalSet(HOUR_OF_DAY, 0); 1653 internalSet(AM_PM, AM); 1654 internalSet(HOUR, 0); 1655 internalSet(MINUTE, 0); 1656 internalSet(SECOND, 0); 1657 internalSet(MILLISECOND, 0); 1658 } 1659 mask |= (HOUR_OF_DAY_MASK|AM_PM_MASK|HOUR_MASK 1660 |MINUTE_MASK|SECOND_MASK|MILLISECOND_MASK); 1661 } 1662 1663 if ((fieldMask & (ZONE_OFFSET_MASK|DST_OFFSET_MASK)) != 0) { 1664 internalSet(ZONE_OFFSET, zoneOffsets[0]); 1665 internalSet(DST_OFFSET, zoneOffsets[1]); 1666 mask |= (ZONE_OFFSET_MASK|DST_OFFSET_MASK); 1667 } 1668 1669 if ((fieldMask & (DAY_OF_YEAR_MASK|WEEK_OF_YEAR_MASK 1670 |WEEK_OF_MONTH_MASK|DAY_OF_WEEK_IN_MONTH_MASK)) != 0) { 1671 int normalizedYear = jdate.getNormalizedYear(); 1672 // If it's a year of an era transition, we need to handle 1673 // irregular year boundaries. 1674 boolean transitionYear = isTransitionYear(jdate.getNormalizedYear()); 1675 int dayOfYear; 1676 long fixedDateJan1; 1677 if (transitionYear) { 1678 fixedDateJan1 = getFixedDateJan1(jdate, fixedDate); 1679 dayOfYear = (int)(fixedDate - fixedDateJan1) + 1; 1680 } else if (normalizedYear == MIN_VALUES[YEAR]) { 1681 CalendarDate dx = jcal.getCalendarDate(Long.MIN_VALUE, getZone()); 1682 fixedDateJan1 = jcal.getFixedDate(dx); 1683 dayOfYear = (int)(fixedDate - fixedDateJan1) + 1; 1684 } else { 1685 dayOfYear = (int) jcal.getDayOfYear(jdate); 1686 fixedDateJan1 = fixedDate - dayOfYear + 1; 1687 } 1688 long fixedDateMonth1 = transitionYear ? 1689 getFixedDateMonth1(jdate, fixedDate) : fixedDate - dayOfMonth + 1; 1690 1691 internalSet(DAY_OF_YEAR, dayOfYear); 1692 internalSet(DAY_OF_WEEK_IN_MONTH, (dayOfMonth - 1) / 7 + 1); 1693 1694 int weekOfYear = getWeekNumber(fixedDateJan1, fixedDate); 1695 1696 // The spec is to calculate WEEK_OF_YEAR in the 1697 // ISO8601-style. This creates problems, though. 1698 if (weekOfYear == 0) { 1699 // If the date belongs to the last week of the 1700 // previous year, use the week number of "12/31" of 1701 // the "previous" year. Again, if the previous year is 1702 // a transition year, we need to take care of it. 1703 // Usually the previous day of the first day of a year 1704 // is December 31, which is not always true in the 1705 // Japanese imperial calendar system. 1706 long fixedDec31 = fixedDateJan1 - 1; 1707 long prevJan1; 1708 LocalGregorianCalendar.Date d = getCalendarDate(fixedDec31); 1709 if (!(transitionYear || isTransitionYear(d.getNormalizedYear()))) { 1710 prevJan1 = fixedDateJan1 - 365; 1711 if (d.isLeapYear()) { 1712 --prevJan1; 1713 } 1714 } else if (transitionYear) { 1715 if (jdate.getYear() == 1) { 1716 // As of Heisei (since Meiji) there's no case 1717 // that there are multiple transitions in a 1718 // year. Historically there was such 1719 // case. There might be such case again in the 1720 // future. 1721 if (era > HEISEI) { 1722 CalendarDate pd = eras[era - 1].getSinceDate(); 1723 if (normalizedYear == pd.getYear()) { 1724 d.setMonth(pd.getMonth()).setDayOfMonth(pd.getDayOfMonth()); 1725 } 1726 } else { 1727 d.setMonth(LocalGregorianCalendar.JANUARY).setDayOfMonth(1); 1728 } 1729 jcal.normalize(d); 1730 prevJan1 = jcal.getFixedDate(d); 1731 } else { 1732 prevJan1 = fixedDateJan1 - 365; 1733 if (d.isLeapYear()) { 1734 --prevJan1; 1735 } 1736 } 1737 } else { 1738 CalendarDate cd = eras[getEraIndex(jdate)].getSinceDate(); 1739 d.setMonth(cd.getMonth()).setDayOfMonth(cd.getDayOfMonth()); 1740 jcal.normalize(d); 1741 prevJan1 = jcal.getFixedDate(d); 1742 } 1743 weekOfYear = getWeekNumber(prevJan1, fixedDec31); 1744 } else { 1745 if (!transitionYear) { 1746 // Regular years 1747 if (weekOfYear >= 52) { 1748 long nextJan1 = fixedDateJan1 + 365; 1749 if (jdate.isLeapYear()) { 1750 nextJan1++; 1751 } 1752 long nextJan1st = LocalGregorianCalendar.getDayOfWeekDateOnOrBefore(nextJan1 + 6, 1753 getFirstDayOfWeek()); 1754 int ndays = (int)(nextJan1st - nextJan1); 1755 if (ndays >= getMinimalDaysInFirstWeek() && fixedDate >= (nextJan1st - 7)) { 1756 // The first days forms a week in which the date is included. 1757 weekOfYear = 1; 1758 } 1759 } 1760 } else { 1761 LocalGregorianCalendar.Date d = (LocalGregorianCalendar.Date) jdate.clone(); 1762 long nextJan1; 1763 if (jdate.getYear() == 1) { 1764 d.addYear(+1); 1765 d.setMonth(LocalGregorianCalendar.JANUARY).setDayOfMonth(1); 1766 nextJan1 = jcal.getFixedDate(d); 1767 } else { 1768 int nextEraIndex = getEraIndex(d) + 1; 1769 CalendarDate cd = eras[nextEraIndex].getSinceDate(); 1770 d.setEra(eras[nextEraIndex]); 1771 d.setDate(1, cd.getMonth(), cd.getDayOfMonth()); 1772 jcal.normalize(d); 1773 nextJan1 = jcal.getFixedDate(d); 1774 } 1775 long nextJan1st = LocalGregorianCalendar.getDayOfWeekDateOnOrBefore(nextJan1 + 6, 1776 getFirstDayOfWeek()); 1777 int ndays = (int)(nextJan1st - nextJan1); 1778 if (ndays >= getMinimalDaysInFirstWeek() && fixedDate >= (nextJan1st - 7)) { 1779 // The first days forms a week in which the date is included. 1780 weekOfYear = 1; 1781 } 1782 } 1783 } 1784 internalSet(WEEK_OF_YEAR, weekOfYear); 1785 internalSet(WEEK_OF_MONTH, getWeekNumber(fixedDateMonth1, fixedDate)); 1786 mask |= (DAY_OF_YEAR_MASK|WEEK_OF_YEAR_MASK|WEEK_OF_MONTH_MASK|DAY_OF_WEEK_IN_MONTH_MASK); 1787 } 1788 return mask; 1789 } 1790 1791 /** 1792 * Returns the number of weeks in a period between fixedDay1 and 1793 * fixedDate. The getFirstDayOfWeek-getMinimalDaysInFirstWeek rule 1794 * is applied to calculate the number of weeks. 1795 * 1796 * @param fixedDay1 the fixed date of the first day of the period 1797 * @param fixedDate the fixed date of the last day of the period 1798 * @return the number of weeks of the given period 1799 */ 1800 private int getWeekNumber(long fixedDay1, long fixedDate) { 1801 // We can always use `jcal' since Julian and Gregorian are the 1802 // same thing for this calculation. 1803 long fixedDay1st = LocalGregorianCalendar.getDayOfWeekDateOnOrBefore(fixedDay1 + 6, 1804 getFirstDayOfWeek()); 1805 int ndays = (int)(fixedDay1st - fixedDay1); 1806 assert ndays <= 7; 1807 if (ndays >= getMinimalDaysInFirstWeek()) { 1808 fixedDay1st -= 7; 1809 } 1810 int normalizedDayOfPeriod = (int)(fixedDate - fixedDay1st); 1811 if (normalizedDayOfPeriod >= 0) { 1812 return normalizedDayOfPeriod / 7 + 1; 1813 } 1814 return CalendarUtils.floorDivide(normalizedDayOfPeriod, 7) + 1; 1815 } 1816 1817 /** 1818 * Converts calendar field values to the time value (millisecond 1819 * offset from the <a href="Calendar.html#Epoch">Epoch</a>). 1820 * 1821 * @exception IllegalArgumentException if any calendar fields are invalid. 1822 */ 1823 protected void computeTime() { 1824 // In non-lenient mode, perform brief checking of calendar 1825 // fields which have been set externally. Through this 1826 // checking, the field values are stored in originalFields[] 1827 // to see if any of them are normalized later. 1828 if (!isLenient()) { 1829 if (originalFields == null) { 1830 originalFields = new int[FIELD_COUNT]; 1831 } 1832 for (int field = 0; field < FIELD_COUNT; field++) { 1833 int value = internalGet(field); 1834 if (isExternallySet(field)) { 1835 // Quick validation for any out of range values 1836 if (value < getMinimum(field) || value > getMaximum(field)) { 1837 throw new IllegalArgumentException(getFieldName(field)); 1838 } 1839 } 1840 originalFields[field] = value; 1841 } 1842 } 1843 1844 // Let the super class determine which calendar fields to be 1845 // used to calculate the time. 1846 int fieldMask = selectFields(); 1847 1848 int year; 1849 int era; 1850 1851 if (isSet(ERA)) { 1852 era = internalGet(ERA); 1853 year = isSet(YEAR) ? internalGet(YEAR) : 1; 1854 } else { 1855 if (isSet(YEAR)) { 1856 era = eras.length - 1; 1857 year = internalGet(YEAR); 1858 } else { 1859 // Equivalent to 1970 (Gregorian) 1860 era = SHOWA; 1861 year = 45; 1862 } 1863 } 1864 1865 // Calculate the time of day. We rely on the convention that 1866 // an UNSET field has 0. 1867 long timeOfDay = 0; 1868 if (isFieldSet(fieldMask, HOUR_OF_DAY)) { 1869 timeOfDay += (long) internalGet(HOUR_OF_DAY); 1870 } else { 1871 timeOfDay += internalGet(HOUR); 1872 // The default value of AM_PM is 0 which designates AM. 1873 if (isFieldSet(fieldMask, AM_PM)) { 1874 timeOfDay += 12 * internalGet(AM_PM); 1875 } 1876 } 1877 timeOfDay *= 60; 1878 timeOfDay += internalGet(MINUTE); 1879 timeOfDay *= 60; 1880 timeOfDay += internalGet(SECOND); 1881 timeOfDay *= 1000; 1882 timeOfDay += internalGet(MILLISECOND); 1883 1884 // Convert the time of day to the number of days and the 1885 // millisecond offset from midnight. 1886 long fixedDate = timeOfDay / ONE_DAY; 1887 timeOfDay %= ONE_DAY; 1888 while (timeOfDay < 0) { 1889 timeOfDay += ONE_DAY; 1890 --fixedDate; 1891 } 1892 1893 // Calculate the fixed date since January 1, 1 (Gregorian). 1894 fixedDate += getFixedDate(era, year, fieldMask); 1895 1896 // millis represents local wall-clock time in milliseconds. 1897 long millis = (fixedDate - EPOCH_OFFSET) * ONE_DAY + timeOfDay; 1898 1899 // Compute the time zone offset and DST offset. There are two potential 1900 // ambiguities here. We'll assume a 2:00 am (wall time) switchover time 1901 // for discussion purposes here. 1902 // 1. The transition into DST. Here, a designated time of 2:00 am - 2:59 am 1903 // can be in standard or in DST depending. However, 2:00 am is an invalid 1904 // representation (the representation jumps from 1:59:59 am Std to 3:00:00 am DST). 1905 // We assume standard time. 1906 // 2. The transition out of DST. Here, a designated time of 1:00 am - 1:59 am 1907 // can be in standard or DST. Both are valid representations (the rep 1908 // jumps from 1:59:59 DST to 1:00:00 Std). 1909 // Again, we assume standard time. 1910 // We use the TimeZone object, unless the user has explicitly set the ZONE_OFFSET 1911 // or DST_OFFSET fields; then we use those fields. 1912 TimeZone zone = getZone(); 1913 if (zoneOffsets == null) { 1914 zoneOffsets = new int[2]; 1915 } 1916 int tzMask = fieldMask & (ZONE_OFFSET_MASK|DST_OFFSET_MASK); 1917 if (tzMask != (ZONE_OFFSET_MASK|DST_OFFSET_MASK)) { 1918 if (zone instanceof ZoneInfo) { 1919 ((ZoneInfo)zone).getOffsetsByWall(millis, zoneOffsets); 1920 } else { 1921 zone.getOffsets(millis - zone.getRawOffset(), zoneOffsets); 1922 } 1923 } 1924 if (tzMask != 0) { 1925 if (isFieldSet(tzMask, ZONE_OFFSET)) { 1926 zoneOffsets[0] = internalGet(ZONE_OFFSET); 1927 } 1928 if (isFieldSet(tzMask, DST_OFFSET)) { 1929 zoneOffsets[1] = internalGet(DST_OFFSET); 1930 } 1931 } 1932 1933 // Adjust the time zone offset values to get the UTC time. 1934 millis -= zoneOffsets[0] + zoneOffsets[1]; 1935 1936 // Set this calendar's time in milliseconds 1937 time = millis; 1938 1939 int mask = computeFields(fieldMask | getSetStateFields(), tzMask); 1940 1941 if (!isLenient()) { 1942 for (int field = 0; field < FIELD_COUNT; field++) { 1943 if (!isExternallySet(field)) { 1944 continue; 1945 } 1946 if (originalFields[field] != internalGet(field)) { 1947 int wrongValue = internalGet(field); 1948 // Restore the original field values 1949 System.arraycopy(originalFields, 0, fields, 0, fields.length); 1950 throw new IllegalArgumentException(getFieldName(field) + "=" + wrongValue 1951 + ", expected " + originalFields[field]); 1952 } 1953 } 1954 } 1955 setFieldsNormalized(mask); 1956 } 1957 1958 /** 1959 * Computes the fixed date under either the Gregorian or the 1960 * Julian calendar, using the given year and the specified calendar fields. 1961 * 1962 * @param era era index 1963 * @param year the normalized year number, with 0 indicating the 1964 * year 1 BCE, -1 indicating 2 BCE, etc. 1965 * @param fieldMask the calendar fields to be used for the date calculation 1966 * @return the fixed date 1967 * @see Calendar#selectFields 1968 */ 1969 private long getFixedDate(int era, int year, int fieldMask) { 1970 int month = JANUARY; 1971 int firstDayOfMonth = 1; 1972 if (isFieldSet(fieldMask, MONTH)) { 1973 // No need to check if MONTH has been set (no isSet(MONTH) 1974 // call) since its unset value happens to be JANUARY (0). 1975 month = internalGet(MONTH); 1976 1977 // If the month is out of range, adjust it into range. 1978 if (month > DECEMBER) { 1979 year += month / 12; 1980 month %= 12; 1981 } else if (month < JANUARY) { 1982 int[] rem = new int[1]; 1983 year += CalendarUtils.floorDivide(month, 12, rem); 1984 month = rem[0]; 1985 } 1986 } else { 1987 if (year == 1 && era != 0) { 1988 CalendarDate d = eras[era].getSinceDate(); 1989 month = d.getMonth() - 1; 1990 firstDayOfMonth = d.getDayOfMonth(); 1991 } 1992 } 1993 1994 // Adjust the base date if year is the minimum value. 1995 if (year == MIN_VALUES[YEAR]) { 1996 CalendarDate dx = jcal.getCalendarDate(Long.MIN_VALUE, getZone()); 1997 int m = dx.getMonth() - 1; 1998 if (month < m) { 1999 month = m; 2000 } 2001 if (month == m) { 2002 firstDayOfMonth = dx.getDayOfMonth(); 2003 } 2004 } 2005 2006 LocalGregorianCalendar.Date date = jcal.newCalendarDate(TimeZone.NO_TIMEZONE); 2007 date.setEra(era > 0 ? eras[era] : null); 2008 date.setDate(year, month + 1, firstDayOfMonth); 2009 jcal.normalize(date); 2010 2011 // Get the fixed date since Jan 1, 1 (Gregorian). We are on 2012 // the first day of either `month' or January in 'year'. 2013 long fixedDate = jcal.getFixedDate(date); 2014 2015 if (isFieldSet(fieldMask, MONTH)) { 2016 // Month-based calculations 2017 if (isFieldSet(fieldMask, DAY_OF_MONTH)) { 2018 // We are on the "first day" of the month (which may 2019 // not be 1). Just add the offset if DAY_OF_MONTH is 2020 // set. If the isSet call returns false, that means 2021 // DAY_OF_MONTH has been selected just because of the 2022 // selected combination. We don't need to add any 2023 // since the default value is the "first day". 2024 if (isSet(DAY_OF_MONTH)) { 2025 // To avoid underflow with DAY_OF_MONTH-firstDayOfMonth, add 2026 // DAY_OF_MONTH, then subtract firstDayOfMonth. 2027 fixedDate += internalGet(DAY_OF_MONTH); 2028 fixedDate -= firstDayOfMonth; 2029 } 2030 } else { 2031 if (isFieldSet(fieldMask, WEEK_OF_MONTH)) { 2032 long firstDayOfWeek = LocalGregorianCalendar.getDayOfWeekDateOnOrBefore(fixedDate + 6, 2033 getFirstDayOfWeek()); 2034 // If we have enough days in the first week, then 2035 // move to the previous week. 2036 if ((firstDayOfWeek - fixedDate) >= getMinimalDaysInFirstWeek()) { 2037 firstDayOfWeek -= 7; 2038 } 2039 if (isFieldSet(fieldMask, DAY_OF_WEEK)) { 2040 firstDayOfWeek = LocalGregorianCalendar.getDayOfWeekDateOnOrBefore(firstDayOfWeek + 6, 2041 internalGet(DAY_OF_WEEK)); 2042 } 2043 // In lenient mode, we treat days of the previous 2044 // months as a part of the specified 2045 // WEEK_OF_MONTH. See 4633646. 2046 fixedDate = firstDayOfWeek + 7 * (internalGet(WEEK_OF_MONTH) - 1); 2047 } else { 2048 int dayOfWeek; 2049 if (isFieldSet(fieldMask, DAY_OF_WEEK)) { 2050 dayOfWeek = internalGet(DAY_OF_WEEK); 2051 } else { 2052 dayOfWeek = getFirstDayOfWeek(); 2053 } 2054 // We are basing this on the day-of-week-in-month. The only 2055 // trickiness occurs if the day-of-week-in-month is 2056 // negative. 2057 int dowim; 2058 if (isFieldSet(fieldMask, DAY_OF_WEEK_IN_MONTH)) { 2059 dowim = internalGet(DAY_OF_WEEK_IN_MONTH); 2060 } else { 2061 dowim = 1; 2062 } 2063 if (dowim >= 0) { 2064 fixedDate = LocalGregorianCalendar.getDayOfWeekDateOnOrBefore(fixedDate + (7 * dowim) - 1, 2065 dayOfWeek); 2066 } else { 2067 // Go to the first day of the next week of 2068 // the specified week boundary. 2069 int lastDate = monthLength(month, year) + (7 * (dowim + 1)); 2070 // Then, get the day of week date on or before the last date. 2071 fixedDate = LocalGregorianCalendar.getDayOfWeekDateOnOrBefore(fixedDate + lastDate - 1, 2072 dayOfWeek); 2073 } 2074 } 2075 } 2076 } else { 2077 // We are on the first day of the year. 2078 if (isFieldSet(fieldMask, DAY_OF_YEAR)) { 2079 if (isTransitionYear(date.getNormalizedYear())) { 2080 fixedDate = getFixedDateJan1(date, fixedDate); 2081 } 2082 // Add the offset, then subtract 1. (Make sure to avoid underflow.) 2083 fixedDate += internalGet(DAY_OF_YEAR); 2084 fixedDate--; 2085 } else { 2086 long firstDayOfWeek = LocalGregorianCalendar.getDayOfWeekDateOnOrBefore(fixedDate + 6, 2087 getFirstDayOfWeek()); 2088 // If we have enough days in the first week, then move 2089 // to the previous week. 2090 if ((firstDayOfWeek - fixedDate) >= getMinimalDaysInFirstWeek()) { 2091 firstDayOfWeek -= 7; 2092 } 2093 if (isFieldSet(fieldMask, DAY_OF_WEEK)) { 2094 int dayOfWeek = internalGet(DAY_OF_WEEK); 2095 if (dayOfWeek != getFirstDayOfWeek()) { 2096 firstDayOfWeek = LocalGregorianCalendar.getDayOfWeekDateOnOrBefore(firstDayOfWeek + 6, 2097 dayOfWeek); 2098 } 2099 } 2100 fixedDate = firstDayOfWeek + 7 * ((long)internalGet(WEEK_OF_YEAR) - 1); 2101 } 2102 } 2103 return fixedDate; 2104 } 2105 2106 /** 2107 * Returns the fixed date of the first day of the year (usually 2108 * January 1) before the specified date. 2109 * 2110 * @param date the date for which the first day of the year is 2111 * calculated. The date has to be in the cut-over year. 2112 * @param fixedDate the fixed date representation of the date 2113 */ 2114 private long getFixedDateJan1(LocalGregorianCalendar.Date date, long fixedDate) { 2115 Era era = date.getEra(); 2116 if (date.getEra() != null && date.getYear() == 1) { 2117 for (int eraIndex = getEraIndex(date); eraIndex > 0; eraIndex--) { 2118 CalendarDate d = eras[eraIndex].getSinceDate(); 2119 long fd = gcal.getFixedDate(d); 2120 // There might be multiple era transitions in a year. 2121 if (fd > fixedDate) { 2122 continue; 2123 } 2124 return fd; 2125 } 2126 } 2127 CalendarDate d = gcal.newCalendarDate(TimeZone.NO_TIMEZONE); 2128 d.setDate(date.getNormalizedYear(), Gregorian.JANUARY, 1); 2129 return gcal.getFixedDate(d); 2130 } 2131 2132 /** 2133 * Returns the fixed date of the first date of the month (usually 2134 * the 1st of the month) before the specified date. 2135 * 2136 * @param date the date for which the first day of the month is 2137 * calculated. The date must be in the era transition year. 2138 * @param fixedDate the fixed date representation of the date 2139 */ 2140 private long getFixedDateMonth1(LocalGregorianCalendar.Date date, 2141 long fixedDate) { 2142 int eraIndex = getTransitionEraIndex(date); 2143 if (eraIndex != -1) { 2144 long transition = sinceFixedDates[eraIndex]; 2145 // If the given date is on or after the transition date, then 2146 // return the transition date. 2147 if (transition <= fixedDate) { 2148 return transition; 2149 } 2150 } 2151 2152 // Otherwise, we can use the 1st day of the month. 2153 return fixedDate - date.getDayOfMonth() + 1; 2154 } 2155 2156 /** 2157 * Returns a LocalGregorianCalendar.Date produced from the specified fixed date. 2158 * 2159 * @param fd the fixed date 2160 */ 2161 private static LocalGregorianCalendar.Date getCalendarDate(long fd) { 2162 LocalGregorianCalendar.Date d = jcal.newCalendarDate(TimeZone.NO_TIMEZONE); 2163 jcal.getCalendarDateFromFixedDate(d, fd); 2164 return d; 2165 } 2166 2167 /** 2168 * Returns the length of the specified month in the specified 2169 * Gregorian year. The year number must be normalized. 2170 * 2171 * @see GregorianCalendar#isLeapYear(int) 2172 */ 2173 private int monthLength(int month, int gregorianYear) { 2174 return CalendarUtils.isGregorianLeapYear(gregorianYear) ? 2175 GregorianCalendar.LEAP_MONTH_LENGTH[month] : GregorianCalendar.MONTH_LENGTH[month]; 2176 } 2177 2178 /** 2179 * Returns the length of the specified month in the year provided 2180 * by internalGet(YEAR). 2181 * 2182 * @see GregorianCalendar#isLeapYear(int) 2183 */ 2184 private int monthLength(int month) { 2185 assert jdate.isNormalized(); 2186 return jdate.isLeapYear() ? 2187 GregorianCalendar.LEAP_MONTH_LENGTH[month] : GregorianCalendar.MONTH_LENGTH[month]; 2188 } 2189 2190 private int actualMonthLength() { 2191 int length = jcal.getMonthLength(jdate); 2192 int eraIndex = getTransitionEraIndex(jdate); 2193 if (eraIndex == -1) { 2194 long transitionFixedDate = sinceFixedDates[eraIndex]; 2195 CalendarDate d = eras[eraIndex].getSinceDate(); 2196 if (transitionFixedDate <= cachedFixedDate) { 2197 length -= d.getDayOfMonth() - 1; 2198 } else { 2199 length = d.getDayOfMonth() - 1; 2200 } 2201 } 2202 return length; 2203 } 2204 2205 /** 2206 * Returns the index to the new era if the given date is in a 2207 * transition month. For example, if the give date is Heisei 1 2208 * (1989) January 20, then the era index for Heisei is 2209 * returned. Likewise, if the given date is Showa 64 (1989) 2210 * January 3, then the era index for Heisei is returned. If the 2211 * given date is not in any transition month, then -1 is returned. 2212 */ 2213 private static int getTransitionEraIndex(LocalGregorianCalendar.Date date) { 2214 int eraIndex = getEraIndex(date); 2215 CalendarDate transitionDate = eras[eraIndex].getSinceDate(); 2216 if (transitionDate.getYear() == date.getNormalizedYear() && 2217 transitionDate.getMonth() == date.getMonth()) { 2218 return eraIndex; 2219 } 2220 if (eraIndex < eras.length - 1) { 2221 transitionDate = eras[++eraIndex].getSinceDate(); 2222 if (transitionDate.getYear() == date.getNormalizedYear() && 2223 transitionDate.getMonth() == date.getMonth()) { 2224 return eraIndex; 2225 } 2226 } 2227 return -1; 2228 } 2229 2230 private boolean isTransitionYear(int normalizedYear) { 2231 for (int i = eras.length - 1; i > 0; i--) { 2232 int transitionYear = eras[i].getSinceDate().getYear(); 2233 if (normalizedYear == transitionYear) { 2234 return true; 2235 } 2236 if (normalizedYear > transitionYear) { 2237 break; 2238 } 2239 } 2240 return false; 2241 } 2242 2243 private static int getEraIndex(LocalGregorianCalendar.Date date) { 2244 Era era = date.getEra(); 2245 for (int i = eras.length - 1; i > 0; i--) { 2246 if (eras[i] == era) { 2247 return i; 2248 } 2249 } 2250 return 0; 2251 } 2252 2253 /** 2254 * Returns this object if it's normalized (all fields and time are 2255 * in sync). Otherwise, a cloned object is returned after calling 2256 * complete() in lenient mode. 2257 */ 2258 private JapaneseImperialCalendar getNormalizedCalendar() { 2259 JapaneseImperialCalendar jc; 2260 if (isFullyNormalized()) { 2261 jc = this; 2262 } else { 2263 // Create a clone and normalize the calendar fields 2264 jc = (JapaneseImperialCalendar) this.clone(); 2265 jc.setLenient(true); 2266 jc.complete(); 2267 } 2268 return jc; 2269 } 2270 2271 /** 2272 * After adjustments such as add(MONTH), add(YEAR), we don't want the 2273 * month to jump around. E.g., we don't want Jan 31 + 1 month to go to Mar 2274 * 3, we want it to go to Feb 28. Adjustments which might run into this 2275 * problem call this method to retain the proper month. 2276 */ 2277 private void pinDayOfMonth(LocalGregorianCalendar.Date date) { 2278 int year = date.getYear(); 2279 int dom = date.getDayOfMonth(); 2280 if (year != getMinimum(YEAR)) { 2281 date.setDayOfMonth(1); 2282 jcal.normalize(date); 2283 int monthLength = jcal.getMonthLength(date); 2284 if (dom > monthLength) { 2285 date.setDayOfMonth(monthLength); 2286 } else { 2287 date.setDayOfMonth(dom); 2288 } 2289 jcal.normalize(date); 2290 } else { 2291 LocalGregorianCalendar.Date d = jcal.getCalendarDate(Long.MIN_VALUE, getZone()); 2292 LocalGregorianCalendar.Date realDate = jcal.getCalendarDate(time, getZone()); 2293 long tod = realDate.getTimeOfDay(); 2294 // Use an equivalent year. 2295 realDate.addYear(+400); 2296 realDate.setMonth(date.getMonth()); 2297 realDate.setDayOfMonth(1); 2298 jcal.normalize(realDate); 2299 int monthLength = jcal.getMonthLength(realDate); 2300 if (dom > monthLength) { 2301 realDate.setDayOfMonth(monthLength); 2302 } else { 2303 if (dom < d.getDayOfMonth()) { 2304 realDate.setDayOfMonth(d.getDayOfMonth()); 2305 } else { 2306 realDate.setDayOfMonth(dom); 2307 } 2308 } 2309 if (realDate.getDayOfMonth() == d.getDayOfMonth() && tod < d.getTimeOfDay()) { 2310 realDate.setDayOfMonth(Math.min(dom + 1, monthLength)); 2311 } 2312 // restore the year. 2313 date.setDate(year, realDate.getMonth(), realDate.getDayOfMonth()); 2314 // Don't normalize date here so as not to cause underflow. 2315 } 2316 } 2317 2318 /** 2319 * Returns the new value after 'roll'ing the specified value and amount. 2320 */ 2321 private static int getRolledValue(int value, int amount, int min, int max) { 2322 assert value >= min && value <= max; 2323 int range = max - min + 1; 2324 amount %= range; 2325 int n = value + amount; 2326 if (n > max) { 2327 n -= range; 2328 } else if (n < min) { 2329 n += range; 2330 } 2331 assert n >= min && n <= max; 2332 return n; 2333 } 2334 2335 /** 2336 * Returns the ERA. We need a special method for this because the 2337 * default ERA is the current era, but a zero (unset) ERA means before Meiji. 2338 */ 2339 private int internalGetEra() { 2340 return isSet(ERA) ? internalGet(ERA) : eras.length - 1; 2341 } 2342 2343 /** 2344 * Updates internal state. 2345 */ 2346 private void readObject(ObjectInputStream stream) 2347 throws IOException, ClassNotFoundException { 2348 stream.defaultReadObject(); 2349 if (jdate == null) { 2350 jdate = jcal.newCalendarDate(getZone()); 2351 cachedFixedDate = Long.MIN_VALUE; 2352 } 2353 } 2354 }