Java Doc for JapaneseImperialCalendar.java in  » 6.0-JDK-Core » Collections-Jar-Zip-Logging-regex » java » util » Java Source Code / Java DocumentationJava Source Code and Java Documentation

 ERA value   Era name    Since (in Gregorian)	    
 ------------------------------------------------------
 0       N/A         N/A
 1       Meiji       1868-01-01 midnight local time
 2       Taisho      1912-07-30 midnight local time
 3       Showa       1926-12-25 midnight local time
 4       Heisei      1989-01-08 midnight local time
 ------------------------------------------------------
 

ERA value 0 specifies the years before Meiji and the Gregorian year values are used. Unlike GregorianCalendar , the Julian to Gregorian transition is not supported because it doesn't make any sense to the Japanese calendar systems used before Meiji. To represent the years before Gregorian year 1, 0 and negative values are used. The Japanese Imperial rescripts and government decrees don't specify how to deal with time differences for applying the era transitions. This calendar implementation assumes local time for all transitions.
author:
   Masayoshi Okutsu
since:
   1.6

Add rule 1.

Add rule 1. The value of field after the call minus the value of field before the call is amount, modulo any overflow that has occurred in field. Overflow occurs when a field value exceeds its range and, as a result, the next larger field is incremented or decremented and the field value is adjusted back into its range.

Add rule 2. If a smaller field is expected to be invariant, but it is impossible for it to be equal to its prior value because of changes in its minimum or maximum after field is changed, then its value is adjusted to be as close as possible to its expected value. A smaller field represents a smaller unit of time. HOUR is a smaller field than DAY_OF_MONTH. No adjustment is made to smaller fields that are not expected to be invariant. The calendar system determines what fields are expected to be invariant.

This method calls JapaneseImperialCalendar.complete() before adding the amount so that all the calendar fields are normalized. If there is any calendar field having an out-of-range value in non-lenient mode, then an IllegalArgumentException is thrown.
Parameters:
  field - the calendar field.
Parameters:
  amount - the signed amount to add to field.
exception:
  IllegalArgumentException - if field isZONE_OFFSET, DST_OFFSET, or unknown,or if any calendar fields have out-of-range values innon-lenient mode.
See Also:   JapaneseImperialCalendar.roll(int,boolean)
See Also:   JapaneseImperialCalendar.add(int,int)
See Also:   JapaneseImperialCalendar.set(int,int)