이 클래스는 음력 관련 함수를 제공합니다.
*현재 1800년 부터 2100년 까지 사용이 가능합니다.
* ** 1) 2008년 11월 11일 평달의 음력 데이터 생성 * LunaDateUtils lunaDate = new LunaDateUtils(2008, 11, 11, false); * 2) 2008년 11월 11일의 양력 데이터 생성 * LunaDateUtils lunaDate = LunaDateUtils.getLunaDate(2008, 11, 11); * 3) 현재 날짜의 음력 데이터 생성 * LunaDateUtils lunaDate = LunaDateUtils.getLunaDate(); * 또는 * LunaDateUtils lunaDate = LunaDateUtils.getLunaDate(new Date()); ** * *
음력일 생성자이다.
* * @param year 음력의 년(1799~2100) * @param month 음력의 월(1~12) * @param day 음력의 일 * @param isLeaf 음력의 윤달여부 */ public LunaDate(int year, int month, int day, boolean isLeaf) { setYear(year); setMonth(month, isLeaf); setDay(day); } /** *음력일 생성자이다.
* * @param dateStr 음력 문자열 * @param pattern 입력 문자열의 패턴 * @param isLeaf 음력의 윤달여부 * @throws ParseException 음력 문자열 분석 실패시 */ public LunaDate(String dateStr, String pattern, boolean isLeaf) throws ParseException { Date date = DateUtils.toDate(dateStr, pattern); setYear(DateUtils.getYear(date)); setMonth(DateUtils.getMonth(date), isLeaf); setDay(DateUtils.getDay(date)); } /** *음력일 생성자이다.
* * @param dateStr 음력 문자열 * @param isLeaf 음력의 윤달여부 * @throws ParseException 음력 문자열 분석 실패시 */ public LunaDate(String dateStr, boolean isLeaf) throws ParseException { if (dateStr == null) { throw new IllegalArgumentException(MessageUtils.format("Illegal Argument Date String \"{}\"", dateStr)); } Date date = DateUtils.toDate(dateStr); setYear(DateUtils.getYear(date)); setMonth(DateUtils.getMonth(date), isLeaf); setDay(DateUtils.getDay(date)); } /** *양력을 음력으로 변환한다.
* * @param solraDate 양력 * @return 음력 */ public static LunaDate toLunaDate(Date solraDate) { int year = DateUtils.getYear(solraDate); Date solraFixedDate = null; LunaDate lunaFixedDate = null; for (int i = CACHE.length - 1; i >= 0; i--) { if ((Integer)CACHE[i][0] < year) { solraFixedDate = (Date)CACHE[i][1]; lunaFixedDate = (LunaDate)CACHE[i][3]; break; } } if (solraFixedDate == null || lunaFixedDate == null) { solraFixedDate = SOLRA_FIXED_DATE; lunaFixedDate = LUNA_FIXED_DATE; } LunaDate lunaDate = (LunaDate)lunaFixedDate.clone(); lunaDate.addDays(DateUtils.getDaysBetween(solraFixedDate, solraDate)); return lunaDate; } /** *양력(년/월/일)을 음력으로 변환한다.
* * @param year 양력의 년 * @param month 양력의 월 * @param day 양력의 일 * @return 음력 */ public static LunaDate toLunaDate(int year, int month, int day) { return toLunaDate(DateUtils.toDate(year, month, day)); } /** *현재 날짜를 기준으로 음력을 생성한다.
* * @return 음력 */ public static LunaDate toLunaDate() { return toLunaDate(new Date()); } /** *양력으로 변환시킨다.
* * @return 양력 */ public Date toSolarDate() { Date solraFixedDate = null; LunaDate lunaFixedDate = null; for (int i = CACHE.length - 1; i >= 0; i--) { if ((Integer)CACHE[i][2] < year) { solraFixedDate = (Date)CACHE[i][1]; lunaFixedDate = (LunaDate)CACHE[i][3]; break; } } if (solraFixedDate == null || lunaFixedDate == null) { solraFixedDate = SOLRA_FIXED_DATE; lunaFixedDate = LUNA_FIXED_DATE; } int amount = lunaFixedDate.getPeriodDays(this); Calendar calendar = DateUtils.toCalendar(solraFixedDate); calendar.add(Calendar.DAY_OF_YEAR, amount); return calendar.getTime(); } /** *년도를 설정합니다.
* * @param year 설정하려는 년도(1799~2100). */ protected void setYear(int year) { if (year < (LUNA_BEGIN_YEAR + 1) && year > (LUNA_END_YEAR - 1)) { throw new IllegalArgumentException("가능한 연도 범위는 " + (LUNA_BEGIN_YEAR + 1) + " ~ " + (LUNA_END_YEAR - 1) + " 까지입니다."); } this.year = year; this.gan = (year+6) % 10; this.jee = (year+8) % 12; this.ddi = (year+8) % 12; } /** *월을 설정합니다.
* * @param month 설정하려는 월(1~12). */ protected void setMonth(int month, boolean isLeaf) { if (month < 1 || month > 12) { throw new IllegalArgumentException("가능한 월 범위는 1 ~ 12 까지입니다."); } // 윤달 가능 여부 검사 if (isLeaf) { if (getDaysOfMonthByIndex(year - LUNA_BEGIN_YEAR, month - 1).length != 2) { throw new IllegalArgumentException(MessageUtils.format("{0}년 {1}월은 윤달이 존재하지 않습니다.", year, month)); } } this.month = month; this.isLeaf = isLeaf; } /** *일을 설정합니다.
* * @param day 설정하려는 일. */ protected void setDay(int day) { int[] daysOfMonth = getDaysOfMonthByIndex(year - LUNA_BEGIN_YEAR, month - 1); int maxDay = isLeaf ? daysOfMonth[1] : daysOfMonth[0]; if (day > maxDay || day < 1) { throw new IllegalArgumentException(MessageUtils.format("{0}년 {1}월({2}달)은 1일부터 {3}일까지만 존재합니다.({4})", year, month, (isLeaf ? "윤" : "평"), maxDay, day)); } this.day = day; } /** *해당 년, 월의 일수를 가져옵니다.
* * @param yearIndex 년 인덱스(0부터 시작) * @param monthIndex 월 인덱스(0부터 시작) * @return */ public static int[] getDaysOfMonthByIndex(int yearIndex, int monthIndex) { return DAYS_OF_MONTH[LUNA_MONTH_TABLE[yearIndex][monthIndex] - 1]; } /** *해당 년, 월의 일수를 가져옵니다.
* * @param year 년 * @param month 월 * @return */ public static int[] getDaysOfMonth(int year, int month) { return getDaysOfMonthByIndex(year - LUNA_BEGIN_YEAR, month - 1); } /** *해당 년의 일수를 가져옵니다.
* * @param yearIndex 년 인덱스(0부터 시작) * @return */ public static int getDaysOfYearByIndex(int yearIndex) { int daysOfYear = 0; int[] daysOfMonth = null; for (int i = 0; i < 12; i++) { daysOfMonth = getDaysOfMonthByIndex(yearIndex, i); daysOfYear += daysOfMonth[0]; if (daysOfMonth.length > 1) { daysOfYear += daysOfMonth[1]; } } return daysOfYear; } /** *해당 년의 일수를 가져옵니다.
* * @param yearIndex 년 * @return */ public static int getDaysOfYear(int year) { return getDaysOfYearByIndex(year - LUNA_BEGIN_YEAR); } /** *해당 일수만큼 더하거나 뺍니다.
* * @param days 일수 * @return */ public LunaDate addDays(int days) { if (days > 0) { return afterDays(days); } else if (days < 0) { return beforeDays(0 - days); } return this; } /** *해당 일수 만큼 더한 날짜를 구합니다.
* * @param days * @return */ public LunaDate afterDays(int days) { if (days < 0) { return beforeDays(days); } int tmpDays = day + days; boolean tmpIsLeaf = isLeaf; boolean notFinished = true; int[] daysOfMonth = null; int i = year - LUNA_BEGIN_YEAR; int j = month - 1; // 처음 한번 윤달 보정 if (tmpIsLeaf) { daysOfMonth = getDaysOfMonthByIndex(i, j); tmpDays += daysOfMonth[0]; } for ( ; (i < LUNA_MONTH_TABLE.length) && (notFinished); i++) { for ( ; (j < 12) && (notFinished); j++) { tmpIsLeaf = false; daysOfMonth = getDaysOfMonthByIndex(i, j); if (tmpDays > daysOfMonth[0]) { tmpDays = tmpDays - daysOfMonth[0]; if (daysOfMonth.length > 1) { if (tmpDays > daysOfMonth[1]) { tmpDays = tmpDays - daysOfMonth[1]; } else { tmpIsLeaf = true; setYear(i + LUNA_BEGIN_YEAR); setMonth(j + 1, tmpIsLeaf); setDay(tmpDays); notFinished = false; } } } else { setYear(i + LUNA_BEGIN_YEAR); setMonth(j + 1, tmpIsLeaf); setDay(tmpDays); notFinished = false; } } // end for j j = 0; } if (notFinished) { throw new IllegalArgumentException("계산 가능한 날짜 범위를 벗어났습니다. (" + (LUNA_BEGIN_YEAR + 1) + "0101~" + (LUNA_END_YEAR - 1) + "12DD)"); } return this; } /** *해당 일수 만큼 뺀 날짜를 구합니다.
* * @param days 양수일 경우 뺀다. * @return */ public LunaDate beforeDays(int days) { if (days < 0) { return afterDays(0 - days); } int tmpDays = day - days; boolean tmpIsLeaf = isLeaf; int[] daysOfMonth = null; int i = year - LUNA_BEGIN_YEAR; int j = month - 1 - 1; // 처음 한번 윤달 보정 if (tmpIsLeaf == false) { daysOfMonth = getDaysOfMonthByIndex(i, j); if (daysOfMonth.length > 1) { tmpDays -= daysOfMonth[1]; } } int tmpYear = year; int tmpMonth = month; int tmpDay = tmpDays; for ( ; (i >= 0) && (tmpDays < 1); i--) { for ( ; (j >= 0) && (tmpDays < 1); j--) { tmpIsLeaf = false; daysOfMonth = getDaysOfMonthByIndex(i, j); if (daysOfMonth.length > 1) { tmpDays += daysOfMonth[1]; if (tmpDays > 0) { tmpIsLeaf = true; tmpYear = i + LUNA_BEGIN_YEAR; tmpMonth = j + 1; tmpDay = tmpDays; } else { tmpDays += daysOfMonth[0]; if (tmpDays > 0) { tmpYear = i + LUNA_BEGIN_YEAR; tmpMonth = j + 1; tmpDay = tmpDays; } } } else { tmpDays += daysOfMonth[0]; if (tmpDays > 0) { tmpYear = i + LUNA_BEGIN_YEAR; tmpMonth = j + 1; tmpDay = tmpDays; } } } // end for j j = 11; } if (tmpDay < 1) { throw new IllegalArgumentException("계산 가능한 날짜 범위를 벗어났습니다. (" + (LUNA_BEGIN_YEAR + 1) + "0101~" + (LUNA_END_YEAR - 1) + "12DD)"); } setYear(tmpYear); setMonth(tmpMonth, tmpIsLeaf); setDay(tmpDay); return this; } public int compare(LunaDate date) { int thisVal = (year * 100000) + (month * 1000) + (day * 10) + (isLeaf ? 1 : 0); int anotherVal = (date.year * 100000) + (date.month * 1000) + (date.day * 10) + (date.isLeaf ? 1 : 0); return (thisVal년을 반환한니다.
* * @return year */ public int getYear() { return year; } /** *월을 반환한니다.
* * @return month */ public int getMonth() { return month; } /** *길을 반환한니다.
* * @return day */ public int getDay() { return day; } /** *윤달여부를 반환한니다.
* * @return 윤달여부 */ public boolean isLeaf() { return isLeaf; } /** *띠 번호를 반환합니다.
*0="쥐",1="소",2="범",3="토끼",4="용",5="뱀",6="말",7="양",8="원숭이",9="닭",10="개",11="돼지"
* * @return 띠번호 */ public int getDdi() { return ddi; } /** *띠를 반환합니다.
*"쥐","소","범","토끼","용","뱀","말","양","원숭이","닭","개","돼지"
* * @return */ public String getDdiAsString() { return HANGUL_DDI[getDdi()]; } /** *천간(天干)의 번호를 반환합니다.
* *
* 육십갑자의 윗부분을 이루는 열 개의 천간
* [갑(甲)·을(乙)·병(丙)·정(丁)·무(戊)·기(己)·경(庚)·신(辛)·임(壬)·계(癸)]
* (갑 = 0, 을 = 1, ..., 계 = 9)
*
* @return 천간(天干)의 번호
*/
public int getGan() {
return gan;
}
/**
* 천간(天干)을 반환합니다.
*
*
* 육십갑자의 윗부분을 이루는 열 개의 천간
* [갑(甲)·을(乙)·병(丙)·정(丁)·무(戊)·기(己)·경(庚)·신(辛)·임(壬)·계(癸)]
*
* @return 천간(天干)
*/
public String getGanAsString() {
return HANJA_GAN[getGan()];
}
/**
* 십이자(十二子)의 번호를 반환합니다.
*
*
* 육십갑자의 아랫부분을 이루는 12개의 지지(地支)
* [자(子)·축(丑)·인(寅)·묘(卯)·진(辰)·사(巳)·오(午)·미(未)·신(申)·유(酉)·술(戌)·해(亥)]
* (자 = 0, 축 = 1, ..., 해 = 11)
*
*
* @return 십이자(十二子)의 번호
*/
public int getJee() {
return jee;
}
/**
* 십이자(十二子)를 반환합니다.
*
*
* 육십갑자의 아랫부분을 이루는 12개의 지지(地支)
* [자(子)·축(丑)·인(寅)·묘(卯)·진(辰)·사(巳)·오(午)·미(未)·신(申)·유(酉)·술(戌)·해(亥)]
*
*
* @return 십이자(十二子)
*/
public String getJeeAsString() {
return HANJA_JEE[getJee()];
}
@Override
public Object clone() {
return new LunaDate(year, month, day, isLeaf);
}
@Override
public boolean equals(Object obj) {
if (obj == null || obj.getClass() != this.getClass()) {
return false;
}
LunaDate another = (LunaDate) obj;
return (this.year == another.year) && (this.month == another.month)
&& (this.day == another.day) && (this.isLeaf == another.isLeaf);
}
@Override
public int hashCode() {
return (year * 100000) + (month * 1000) + (day * 10) + (isLeaf ? 1 : 0);
}
@Override
public String toString() {
StringBuilder buffer = new StringBuilder();
buffer.append("LunaDateUtils[");
buffer.append("year = ").append(year);
buffer.append(", month = ").append(month);
buffer.append(", day = ").append(day);
buffer.append(", isLeaf = ").append(isLeaf);
buffer.append(", gan = ").append(getGanAsString());
buffer.append(", jee = ").append(getJeeAsString());
buffer.append(", ddi = ").append(getDdiAsString());
buffer.append("]");
return buffer.toString();
}
}