JapaneseDate
JapaneseDate (일본 제국 달력의 날짜)
일본 제국 달력(Japanese Imperial calendar) 시스템의 날짜를 나타내는 클래스예요. 이 날짜는 일본 제국 달력을 사용하며, 이 달력은 주로 일본에서 사용돼요.
본문
일본 제국 달력 시스템은 연호 기반 연도 번호를 제외하고 ISO 달력 시스템과 같아요. proleptic-year는 ISO proleptic-year와 같도록 정의돼요. 일본은 메이지 6년부터 그레고리력을 도입했고, 메이지 및 이후 연호만 지원되며, 메이지 6년 1월 1일 이전 날짜는 지원되지 않아요.
예를 들어 일본 연도 "Heisei 24"는 ISO 연도 "2012"에 해당해요.
japaneseDate.get(YEAR_OF_ERA); // returns 24
japaneseDate.get(YEAR); // returns 2012
japaneseDate.get(ERA); // returns 2, JapaneseChronology.ERA_HEISEI
날짜를 만들려면 JapaneseChronology.INSTANCE.date(era, yearOfEra, month, day)를 쓰거나, ISO 날짜를 변환하는 게 편할 수 있어요.
JapaneseDate date = JapaneseChronology.INSTANCE.date(JapaneseEra.HEISEI, 24, 12, 25);
이 클래스는 값 기반 클래스(value-based class)예요. 동일한 인스턴스는 서로 교환 가능하게 취급하고 동기화에 인스턴스를 사용하지 않아야 해요. 그렇게 하면 예측 불가능한 동작이 발생할 수 있어요. 비교는 equals 메서드를 사용해야 해요.