[Java]Calendar클래스

날짜와 시간

▶ java.util.Date
   - 날짜와 시간을 다룰 목적으로 만들어진 클래스 (JDK 1.0)
   - Date의 메서드는 거의 deprecated(사용안함) 되었지만, 여전히 쓰이고는 있다.

▶ java.util.Calendar
   - Date클래스를 개선한 새로운 클래스(JDK 1.1). 여전히 단점이 존재

▶ java.time 패키지
   - Date와 Calendar의 단점을 개선한 새로운 클래스들을 제공(JDK 1.8)
   - Date와 Calendar의 단점이었던 날짜와 시간을 따로 다룰 수 있다. ( LocalDate, LocalTime, LocalDateTime )

---

Calendar클래스

Calendar클래스는 추상 클래스이므로 getInstance()를 통해 구현된 객체를 얻어야 한다.

위 코드처럼 바로 객체를 생성하려면 에러가 발생하게된다.

Calendar에는 서양력, 불교력, 일본력이 있다.

그렇기에 getInstance()를 하게 되면 사용자 시스템의 날짜와 시간을 파악해 사용자에 맞는 객체를 반환하게 된다.

우리는 서양력(GregorianCalendar)을 사용함으로 getInstance()를 하게되면 new GregorianCalendar()를 반환받는 것이다.

여기서 바로 new GregorianCalendar()를 사용 안 하고, getInstance()를 사용하는 이유는

만약 사용자가 서양력을 보다가 불교력을 봐야 하는 상황이 오면 코드를 바꿔야 하기 때문이다.

---

get()

get()은 날짜와 시간 필드를 가져오는 메서드이다 - int get(int field)

이렇게 Calendar의 객체를 getInstance()를 통해 현재 날짜와 시간으로 생성하고,

cal.get(Calendar.YEAR)을 적으면 올해가 몇 년인지 thisYear에 할당된다.

cal.getActualMaximum(Calendar.DATE)를 사용하면 이 달의 마지막 날이 lastDayOfMonth에 할당된다.

이렇게 Calendar에 정의된 날짜와 관련된 필드는 다음과 같다.

MONTH(월)을 사용할 때 주의할 점은 0월부터 시작한다는 것이다. ( 0월 → 1월 , 8월 → 9월 )

Calendar에 정의된 시간과 관련된 필드는 다음과 같다.

이러한 필드들이 존재한다는걸 참고하고, 필요할 때 찾아서 사용하도록 하자.

class Ex10_1 {
	public static void main(String[] args) 
	{  // 기본적으로 현재날짜와 시간으로 설정된다.
		Calendar today = Calendar.getInstance();	
		System.out.println("이 해의 년도 : " + today.get(Calendar.YEAR));
 	   System.out.println("월(0~11, 0:1월): " + today.get(Calendar.MONTH));
	  	System.out.println("이 해의 몇 째 주: " 
                                    + today.get(Calendar.WEEK_OF_YEAR)); 
		System.out.println("이 달의 몇 째 주: " 
                                    + today.get(Calendar.WEEK_OF_MONTH));
		// DATE와 DAY_OF_MONTH는 같다.
	 	System.out.println("이 달의 몇 일: " + today.get(Calendar.DATE));
	 	System.out.println("이 달의 몇 일: " + today.get(Calendar.DAY_OF_MONTH));
		System.out.println("이 해의 몇 일: " + today.get(Calendar.DAY_OF_YEAR));
	  	System.out.println("요일(1~7, 1:일요일): " 
		 + today.get(Calendar.DAY_OF_WEEK)); // 1:일요일, 2:월요일, ... 7:토요일
	 	System.out.println("이 달의 몇 째 요일: "
                               + today.get(Calendar.DAY_OF_WEEK_IN_MONTH));
		System.out.println("오전_오후(0:오전, 1:오후): "
                               + today.get(Calendar.AM_PM));
		System.out.println("시간(0~11): " + today.get(Calendar.HOUR));
		System.out.println("시간(0~23): " + today.get(Calendar.HOUR_OF_DAY));
		System.out.println("분(0~59): " + today.get(Calendar.MINUTE));
		System.out.println("초(0~59): " + today.get(Calendar.SECOND));
		System.out.println("1000분의 1초(0~999): " 
                                      + today.get(Calendar.MILLISECOND));
 		// 천분의 1초를 시간으로 표시하기 위해 3600000으로 나누었다.(1시간 = 60 * 60초)
		System.out.println("TimeZone(-12~+12): " 
                    + (today.get(Calendar.ZONE_OFFSET)/(60*60*1000))); 
		System.out.println("이 달의 마지막 날: " 
            + today.getActualMaximum(Calendar.DATE) ); // 이 달의 마지막 일을 찾는다
	}
}

위 코드의 출력문은 다음과 같다.

이 해의 년도 : 2022
월(0~11, 0:1월): 10
이 해의 몇 째 주: 48
이 달의 몇 째 주: 4
이 달의 몇 일: 25
이 달의 몇 일: 25
이 해의 몇 일: 329
요일(1~7, 1:일요일): 6
이 달의 몇 째 요일: 4
오전_오후(0:오전, 1:오후): 0
시간(0~11): 9
시간(0~23): 9
분(0~59): 26
초(0~59): 5
1000분의 1초(0~999): 380
TimeZone(-12~+12): 9
이 달의 마지막 날: 30

---

set()

get()을 통해서 날짜와 시간 관련된 정보를 얻어왔다면, set() 메서드를 통해서 날짜와 시간을 지정도 가능하다.

set() 메서드를 사용하는 코드는 위와 같다.

set() 메서드에는 오버로딩된 여러가지 set() 메서드가 있다.

년, 월, 일, 시, 분, 초 를 다양하게 지정할 수도 있다.

만약 2017년 8월 15일을 지정하려고 한다면,  date1.set(2017, 7, 15);로 지정하면 된다.

0월부터 시작이기 때문에 월에는 7을 적어야 한다. 

또한 date1.set(Calendar.YEAR, 2017) 이렇게 년만 따로 지정할수도 있다.

하지만 위 set()의 오버로딩된 코드를 보면 알다시피 시, 분, 초만 따로 한 번에 지정할 수 없다.

그렇기에 위 코드처럼 시, 분, 초를 각각 하나씩 set()해주면 된다.

그렇다면 set()을 활용한 예제를 살펴보자.

import java.util.*;

class Ex10_2 {
	public static void main(String[] args) {
		// 요일은 1부터 시작하기 때문에, DAY_OF_WEEK[0]은 비워두었다.
		final String[] DAY_OF_WEEK = {"","일","월","화","수","목","금","토"};
 
		Calendar date1 = Calendar.getInstance();
		Calendar date2 = Calendar.getInstance();

		// month의 경우 0부터 시작하기 때문에 4월인 경우, 3로 지정해야한다.
		// date1.set(2019, Calendar.APRIL, 29);와 같이 할 수도 있다.
		date1.set(2019, 3, 29); // 2019년 4월 29일로 날짜를 설정한다. 
		System.out.println("date1은 "+ toString(date1) 
                  + DAY_OF_WEEK[date1.get(Calendar.DAY_OF_WEEK)]+"요일이고,");
		System.out.println("오늘(date2)은 " + toString(date2) 
                 + DAY_OF_WEEK[date2.get(Calendar.DAY_OF_WEEK)]+"요일입니다.");

	   // 두 날짜간의 차이를 얻으려면, getTimeInMillis() 천분의 일초 단위로 변환해야한다
   	long difference = 
            (date2.getTimeInMillis() - date1.getTimeInMillis())/1000;
		System.out.println("그 날(date1)부터 지금(date2)까지 "
                                           + difference +"초가 지났습니다.");
		System.out.println("일(day)로 계산하면 "+ difference/(24*60*60) 
                                     +"일입니다."); // 1일 = 24 * 60 * 60
	}

	public static String toString(Calendar date) {
		return date.get(Calendar.YEAR)+"년 "+ (date.get(Calendar.MONTH)+1) 
                            +"월 " + date.get(Calendar.DATE) + "일 ";
	}
}

위 코드의 출력문은 다음과 같다.

date1은 2019년 4월 29일 월요일이고,
오늘(date2)은 2022년 11월 25일 금요일입니다.
그 날(date1)부터 지금(date2)까지 112838400초가 지났습니다.
일(day)로 계산하면 1306일입니다.

위 예제에서는 date1에는 시간을 지정하여 설정하였고, date2에는 오늘 날짜로 지정을 했다.

toString을 오버라이딩하여 toString(date1)을 하면 해당 년, 월, 일이 반환된다.

또한 date1과 date2의 날짜 간격을 확인하기 위해서 difference변수를 만들고,

getTimeInMillis() 메서드를 사용하여 date1의 밀리세컨드에서 date2의 밀리세컨드를 뺄셈 하여 

나온 값을 1000으로 나누어주면 date1과 date2 사이의 날짜가 초 단위로 difference에 할당된다.

그것을 하루 단위로 변환하면 1일을 초 단위로 변환하면 24 * 60 * 60이다.

그럼 difference에서 (24 * 60 * 60)을 나누어주면 date1과 dat2 사이가 며칠인지 출력된다.

 

그렇다면, 시간을 활용한 예제도 확인해보자.

import java.util.*;

class Ex10_3 {
	public static void main(String[] args) {
		final int[] TIME_UNIT = {3600, 60, 1}; // 큰 단위를 앞에 놓는다.
		final String[] TIME_UNIT_NAME = {"시간 ", "분 ", "초 "};

		Calendar time1 = Calendar.getInstance();
		Calendar time2 = Calendar.getInstance();

		time1.set(Calendar.HOUR_OF_DAY, 10); // time1을 10시 20분 30초로 설정
		time1.set(Calendar.MINUTE, 20);
		time1.set(Calendar.SECOND, 30);

		time2.set(Calendar.HOUR_OF_DAY, 20); // time2을 20시 30분 10초로 설정
		time2.set(Calendar.MINUTE, 30);
		time2.set(Calendar.SECOND, 10);

		System.out.println("time1 :"+time1.get(Calendar.HOUR_OF_DAY)+"시 "
		+time1.get(Calendar.MINUTE)+"분 "+time1.get(Calendar.SECOND)+"초");
		System.out.println("time2 :"+time2.get(Calendar.HOUR_OF_DAY)+"시 "
		+time2.get(Calendar.MINUTE)+"분 "+time2.get(Calendar.SECOND)+"초");

		long difference = 
		Math.abs(time2.getTimeInMillis() - time1.getTimeInMillis())/1000;
		System.out.println("time1과 time2의 차이는 "+ difference +"초 입니다.");

		String tmp = "";
		for(int i=0; i < TIME_UNIT.length;i++) { 
			  tmp += difference/TIME_UNIT[i] + TIME_UNIT_NAME[i]; 
			  difference %= TIME_UNIT[i];
		} 
		System.out.println("시분초로 변환하면 " + tmp + "입니다.");
	}
}

위 예제의 출력문은 다음과 같다.

time1 :10시 20분 30초
time2 :20시 30분 10초
time1과 time2의 차이는 36580초 입니다.
시분초로 변환하면 10시간 9분 40초 입니다.

위 예제는 시간(time1)과 시간(time 2)의 시간과 두 시간 사이의 간격을 출력하는 코드이다.

먼저 1시간, 1분, 1초를 모두 초단위로 할당한 배열 TIME_UNIT을 만들어준다.

이때 꼭 큰 숫자가 먼저 오도록 만들어야 한다.

다음으로 문자열 배열을 만들어 "시간" , "분" , "초"를 선언한다.

time1객체와 time2객체를 생성하여 각각 시, 분, 초를 선언해주고,

그 사이의 간격을 확인하는 코드인 getTimeInMillis()를 사용하여 time1과 time2의 천분의 일초를 뺄셈 하여,

1000을 나누어 초 단위로 변환한다.

그럼 time1과 time2의 사이의 초를 difference에 할당된다.

그리고 그 초를 시간 분 초 단위로 바꾸기 위해 문자열 변수를 하나 생성을 해주고,

for문을 사용해 difference(time1과 time2 사이의 초단위) / TIME_UNIT[i] + TIME_UNIT_NAME[i] 를 한다.

그럼 for문이 반복하면서 배열의 0번째 인덱스부터 가져오면서

tmp에는 그 사이의 초단위인 difference를 시간, 분, 초 단위로 변환한 값이 들어가게 된다.

여기서 difference %= TIME_UNIT[i]를 적은 이유는 difference에서 시간 단위가 빠지고 남은 수를 

다시 difference에 할당해야 하기 때문이다.

---

clear()

clear()는 Calendar객체의 모든 필드를 초기화하는 메서드이다.

처음에 Calendar객체를 생성하면 현재 날짜와 시간으로 객체가 생성이 된다.

그리고 그 객체를 clear()하게 되면 1970년 1월 1일 00:00:00으로 초기화된다.

또한 clear(int field)를 통해서 Calendar객체의 특정 필드만 초기화할 수도 있다.

Calendar 객체를 생성하고 현재 시간으로 해야 하는 것이 아니라면 clear()을 꼭 해줘야 한다.

그리고 set()을 해야지 계산이 정확해진다.

그 이유로는 자바에서 컴파일하면서 객체가 생성되는 시간 차이가 0.000...n초가 발생하게 되는데

그러한 미세한 초 차이 때문에 1일이 모자라거나 정확하지 않은 차이가 나는 상황이 생기기 때문이다.

---

add(), roll()

add()는 특정 필드의 값을 증가 또는 감소하는 메서드이다. ( 다른 필드에 영향이 있다 )

위 코드처럼 양수로 더하기 뿐만 아니라 음수로 빼기도 가능하다.

일(DATE)에 1을 더해서 9월 1일이 되고, 8달을 빼서 1월 1일이 된다.

 

roll()은 특정 필드의 값을 증가 또는 감소하는 메서드이다. ( 다른 필드에 영향이 없다 )

roll()은 기능 자체는 add()와 동일하지만, roll()은 다른 필드에 영향을 끼치지 않는다.

즉, 1일을 더하면 7월 1일이 되고, 7월 1일에서 8달을 빼면 2020년 12월 1일이 되는 것이다.

 

import java.util.*;

class Ex10_4 {
	public static void main(String[] args) {
		Calendar date = Calendar.getInstance();
		date.set(2019, 7, 31);	// 2019년 8월 31일

		System.out.println(toString(date));
		System.out.println("= 1일 후 =");
		date.add(Calendar.DATE, 1);
		System.out.println(toString(date));

		System.out.println("= 6달 전 =");
		date.add(Calendar.MONTH, -6);
		System.out.println(toString(date));

		System.out.println("= 31일 후(roll) =");
		date.roll(Calendar.DATE, 31);
		System.out.println(toString(date));

		System.out.println("= 31일 후(add) =");
		date.add(Calendar.DATE, 31);
		System.out.println(toString(date));
	}

	public static String toString(Calendar date) {
		return date.get(Calendar.YEAR)+"년 "+ (date.get(Calendar.MONTH)+1) 
                   +"월 " + date.get(Calendar.DATE) + "일";
	}
}

위 코드는 처음 날짜를 지정하고 add()와 roll()을 사용해 날짜를 바꾸는 코드이다.

제일 처음에 2019년 8월 31일로 지정을 하고 add()로 1일을 더하면 2019년 9월 1일이 된다.

그리고, add()를 통해 6달을 빼면 2019년 3월 1일이 되고,

roll()를 사용해 31일을 더하면 똑같이 2019년 3월 1일이 된다. ( roll()은 다른 필드에 영향을 주지 않는다. )

그리고 다시 add()로 31일을 더하면 2019년 4월 1일이 된다. ( add()는 다른 필드에 영향을 준다. )

---

Date와 Calendar간의 변환

Date의 메서드는 대부분 deprecated 되었지만 여전히 사용 중이다.