날짜와 시간 & 형식화

📌 날짜와 시간

: 자바에서 날짜와 시간과 관련된 클래스와 패키지에는 Date, Calendar, java.time이 있음! 요즘은 최근 추가된 java.time 패키지를 사용 but 아직 Date와 Calendar을 사용하는 프로그램이 많으므로 배워 놓긴 해야 함!

 

✔️ Calendar

https://docs.oracle.com/javase/8/docs/api/java/util/Calendar.html

Calendar (Java Platform SE 8 )

: Calendar은 추상 클래스, 그래서 getInstance() 메서드로 인스턴스를 얻어야 함

: Calendar의 구현 클래스로는 GregorianCalendar와 BuddhistCalendar가 있고 태국 외의 국가에서는 GregorianCalendar를 사용

Calendar cal = Calendar.getInstance(); // new GregorianCalendar() 사용X (DIP)

Calendar today = Calendar.getInstance();
today.get(Calendar.YEAR); // 2023

🔎 get()함수 안에 넣을 수 있는 필드

: (Calendar.) YEAR, MONTH, DATE( = DAY_OF_MONTH), AM_PM, ...

 

✔️ Date

Calendar cal = Calendar.getInstance();
Date d = new Date(cal.getTimeInMillis());

Date d = new Date();
Calendar cal = Calendar.getInstance();
cal.getTime(d);

 

 

📌 형식화

: 숫자, 날짜, 텍스트 데이터를 일정한 형식에 맞게 표현할 수 있는 방법을 객체지향적으로 설계하여 표준화

https://docs.oracle.com/javase/8/docs/api/java/text/package-summary.html

java.text (Java Platform SE 8 )

 

 

✔️ DecimalFormat

: 숫자를 형식화

https://docs.oracle.com/javase/8/docs/api/java/text/DecimalFormat.html

DecimalFormat (Java Platform SE 8 )

 

🔎 DecimalFormat 패턴에 사용되는 몆가지 기호

▪️ 0 : 10진수

▪️ # : 10진수

▪️ . : 소수점

▪️ , : 단위 구분자

 

DecimalFormat df = new DecimalFormat("#.#");
DecimalFormat df2 = new DecimalFormat("#.###E0");

df.format(1234567.89); // 1234567.9
df2.parse(1234567.89); // 1.235E6

 

✔️ SimpleDateFormat

https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html

SimpleDateFormat (Java Platform SE 8 )

Date today = new Date();
SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd");
df.format(today); // 2023-08-12

❕ Date 인스턴스만 format() 메서드를 사용할 수 있기 때문에 Calendar → Date로 바꿔줘야 함!

 

DateFormat dfIn = new DateFormat("yyyy/MM/dd");
DateFormat dfOut = new DateFormat("yyyy-MM-dd");

Date d = dfIn.parse("2023/05/31");
dfOut.format(d); // 2023-05-31;

 

🔎 SimpleDateFormat 패턴에 사용되는 몆가지 기호

▪️ y : 년도

▪️ M : 월 (ex. 10, 10월, OCT)

▪️ d : 일 (ex. 15)

▪️ E : 요일 (ex. 월)

▪️ H : 시간(0~23)

▪️ m : 분(0~59)

▪️ s : 초(0~59)

▪️ z : Time zone (ex. GMT+9:00)

 

✔️ ChoiceFormat

: 특정 범위에 속한 값을 문자열로 변환

String pattern = "60#D|70#C|80<B|90#A"
ChoiceFormat form = new ChoiceFormat(pattern);

form.format("80"); // C

❕ limit#value 또는 limit<value로 패턴을 만들 수 있음! #는 경계값을 범위에 포함, <는 포함X

 

✔️ MessageFormat

: 데이터를 정해진 양식에 맞게 출력할 수 있도록 도와줌. 다수의 데이터를 같은 양식으로 출력할 때 사용하면 좋음!

❕ parse() 메서드를 통해 지정된 양식에서 필요한 데이터만을 손쉽게 추출할 수 있음

String tableName = 'users';
String msg = "INSERT INTO " + tableName 
			+ " VALUE (''{0}'',''{1}'',''{2}'',''{3}'');";
Objact[][] args = {
    { "정의진", "010-0000-0000", "23", "05-31" }, 
    ...
};

for(Object obg: args) {
    String result = MessageFormat.format(msg, args);
}

 

 

📌 java.time 패키지

https://docs.oracle.com/javase/8/docs/api/java/time/package-summary.html

java.time (Java Platform SE 8 )

✔️ java.time과 하위 패키지의 클래스들은 String 클래스처럼 불변 객체! (즉, 날짜나 시간을 변경하면 기존 객체를 변경하는 것이 아니라 새로운 객체를 반환)

 

💁🏻‍♀️ Calendar는 가변 객체인데, 왜 불변 객체가 되었나요?

💡 멀티 쓰레드 환경에서 동시에 여러 쓰레드가 같은 객체에 접근할 수 있기 때문에 Calendar와 같이 변경가능한 객체는 멀티 쓰레드 환경에서 안전하지 못함! 

 

✔️ java.time 패키지의 핵심 클래스

 

1️⃣ LocalDate와 LocalTime

: LocalDate는 날짜 표현 클래스이고, LocalTime는 시간 표현 클래스

https://docs.oracle.com/javase/8/docs/api/java/time/LocalDate.html

LocalDate (Java Platform SE 8 )

 

✔️ 생성하기 - now(), of(), parse()

LocalDate date = LocalDate.now(); // 현재 날짜(ex. 2023-08-12)
LocalTime time = LocalTime.now(); // 현재 시간(ex. 21:54:01.875)

LocalDate date = LocalDate.of(2023, 08, 31);
LocalTime time = LocalTime.of(23, 59, 59);

❕ of() 메서드는 다양한 매개변수를 가지고 오버로딩되어 있기 때문에 공식문서를 찾아보기!

❕parse() 메서드를 이용하면 문자열 → 날짜/시간으로 변환 가능!

LocalDate birthDate = LocalDate.parse("2000-05-31");
LocalTime tile = LocalTime.parse("23:59:59");

 

✔️ 특정 필드 값 가져오기 - get(), getXXX()

🔎 LocalDate 클래스

메서드	설명
int getYear()	년도(ex. 2023)
int getMonthValue()	월(ex. 10)
Month getMonth()	월(ex. DECEMBER) getMonth().getValue() = 12
int getDayOfMonth()	일(ex. 31)
int getDayOfYear()	같은 해의 1월 1일부터 몇번째 일(ex. 365)
DayOfWeek getDayOfWeek()	요일(ex. FRIDAY) getDayOfWeek().getValue() = 5
int lengthOfMonth()	같은 달의 총 일수(ex. 31)
int lengthOfYear()	같은 해의 총 일수(ex. 365) 윤년이면 366
boolean isLeapYear()	윤년여부 확인

 

🔎 LocalTime 클래스

메서드	설명
int getHour()	시(ex. 23)
int getMinute()	분(ex. 59)
int getSecond()	초(ex. 59)
int getNano()	나노초(ex. 0)

 

❕ get(), getLong() 메서드를 쓰고 원하는 필드를 직접 인자로 넣어줄 수 있음!

int get(TemporalField field)
long getLong(TemporalField field)

💁🏻‍♀️ TemporalField?

👩🏻‍🏫 날짜와 시간의 단위를 정의해 놓은 것이 TemporalUnit 인터페이스이고, 이 인터페이스를 구현한 것이 열거형 ChronoUnit임!

그리고 TemporalField는 년, 월, 일 등 날짜와 시간의 필드를 정의해 놓은 것이며 열거형 ChronoField가 이 인터페이스를 구현!

TemporalField(ChronoField)	설명
ERA	시대
YEAR	년
MONTH_OF_YEAR	월
DAY_OF_MONTH	일
DAY_OF_WEEK	요일 (1:월, 2:화 ...)
AMPM_OF_DAY	오전/오후
HOUR_OF_DAY	시간(0~23)
HOUR_OF_AMPM	시(0~11)
MINUTE_OF_HOUR	분
SECOND_OF_MINUTE	초

❕ ChronoField 상수필드의 일부분 이므로 공식문서를 찾아보기!

❕사용할 수 있는 필드는 클래스마다 다름! (ex. LocalDate는 날짜를 표현하기 위한 것이므로 MINUTE_OF_HOUR같은 필드 지원X)

    → isSupported() 메서드로 해당 필드 지원 여부를 확인 할 수 있음!

LocalDate today = LocalDate.now()
today.isSupported(ChronoField.MINUTE_OF_HOUR); // false

 

✔️ 특정 필드 값 변경하기 -with(), plus(), minus()

▪️ with() - 원하는 필드를 직접 변경

LocalDate today = LocalDate.now();
today.withYear(2000); // 2000년도로 변경

▪️ plus(), minus() - 특정 필드에 값을 더하거나 빼기

today.plus(23, ChronoUnit.YEARS);
today.plusYears(23);

❕ LocalTime의 truncatedTo() 메서드는 지정된 것보다 작은 단위의 필드를 0으로 만듦

LocalTime time = LocalTime.of(12, 34, 56);
time.truncatedTo(ChronoUnit.HOURS); // 12:00:00

 

✔️ 날짜와 시간 비교하기 -isAfter(), isBefore(), isEqual()

boolean isAfter(ChronoLocalDate other)
boolean isBefore(ChronoLocalDate other)
boolean isEqual(ChronoLocalDate other)

❕ LocalTime도 compareTo()가 적절하게 오버라이딩되어 있어서 compareTo()를 통해 비교 가능!

 

2️⃣ Instant

: Date와 유사한 클래스로 애포크 타임(1970-01-01 00:00:00 UTC)부터 경과된 시간을 나노초 단위로 표현 

: 계산에 유리

Instant now = Instant.now();
Instant now2 = Instant.ofEpochSecond(now.getEpochSecond());
Instant now3 = Instant.ofEpochSecond(now.getEpochSecond(), now.getNono());

long epochSec = now.getEpochSecond();
int nano = now.getNano();
long milli = now.toEpochMilli();

❕ Instant는 항상 UTC(+00:00)을 기준으로 하기 때문에, LocalTime과 차이가 있을 수 있음!

❕ Instant는 Date를 대체하기 위한 것이므로 Date와 변환 가능!

static Date from(Instant instant)
Instant toInstant()

 

3️⃣ LocalDateTime과 ZonedDateTime

: LocalDateTime은 시간(LocalDate) + 날짜(LocalTime)를 합친 것이고 ZonedDateTime은 거기에 시간대를 추가한 것!

LocalDateTime dateTime = LocalDateTime.now(); // 2023-08-12T21:54:01.875
ZonedDateTime dateTimeInKr = ZonedDateTime.now(); // 2023-08-12T21:54:01.875+9:00[Asia/Seoul]

LocalDateTime dateTime = LocalDateTime.of(date, time);
ZonedDateTime zDateTime = ZonedDateTime.of(dateTime, ZoneId.of("Asia/Seoul"));

 

✔️ LocalDateTime을 LocalDate/LocalTime으로 변환하기

LocalDateTime dt = LocalDateTime.of(2023, 8, 31, 12, 34, 56);
LocalDate date = dt.toLocalDate();
LocalTime time = dt.toLocalTime();

 

❕ LocalDate, LocalTime, LocalDateTime, ZonedDateTime등 날짜와 시간을 표현하기 위한 클래스들은 모두 Temporal, TemporalAccessor, TemporalAdjuster 인터페이스를 구현함!

 

4️⃣ Period와 Duration

: Period는 날짜의 차이를, Duration은 시간의 차이를 계산하기 위한 것

 

✔️ between() - Period와 Duration 생성하기

LocalDate date1 = LocalDate(2023, 1, 1);
LocalDate date2 = LocalDate(2023, 12, 31);
Period pe = Period.between(date1, date2); // date1이 나중이면 음수 반환!

LocalTime time1 = LocalTime(00, 00, 00);
LocalTime time2 = LocalTime(12, 34, 31);
Duration du = Duration.between(time1, time2);

 

✔️ get() - 필드값 얻기

int year = pe.get(ChronoUnit.YEARS);
long sec = du.get(ChronoUnit.SECONDS);

: LocalDate는 Years, Months, Days로 값을 가져올 수 있고, LocalTime은 Seconds, Nanos(Years, Months, Days❌)로 값을 가져올 수 있음!

 

💡 Duration → LocalTime으로 변환해서 해결 가능!

LocalTime tmpTime = LocalTime.of(0, 0).plusSeconds(du.getSeconds());

int hour = tmpTime.getHour();
int min = tmpTime.getMinute();
int sec = tmpTime.getSecond();

 

✔️ util() - 디데이 구하기

: between()과 같은 일을 하지만 between()은  static 메서드이고, util()은 인스턴스 메서드임!

long dday = todat.util(birthDay, ChronoUnit.DAYS);

 

✔️ of(), with()

: Period와 Duration에도 of()와 with() 함수가 존재!

 

✔️ 사칙연산, 비교연산, 기타 메서드

▪️ plus(), minus(), multipliedBy(), dividedBy()

❕ Period를 위한 나눗셈 메서드는 없음!

▪️ isNegative(), isZero(), abs()

❕ Period를 위한 abs()가 없음!

💡 해결책

if(pe.isNegative()) {
    pe = pe.negated();
}

▪️ normalized()

: Period에만 존재하는 메서드, 월(month)가 12를 넘지 않게 바꿔줌!

pe = Period.of(1, 13, 32).normalized(); // 2년 1개월 32일로 바뀜

❕ 일(day)은 바뀌지 않음

 

✔️ 다른 단위로 변환 - toTotalMonth(), toDays(), toHours(), toMinutes()

: Period와 Duration을 다른 단위의 값으로 변환

❕ LocalDate에는 toEpochDay()라는 메서드도 존재! '1970-01-01'부터 날짜를 세어서 반환!

 

 

📌 java.time 파싱과 포맷

: java.time.format 패키지에 형식화와 관련된 클래스가 있음

https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html

DateTimeFormatter (Java Platform SE 8 )

: DateTimeFormatter가 핵심!

LocalDate date = LocalDate.of(2000, 5, 31);
String yyyymmdd = DateTimeFormatter.ISO_LOCAL_DATE.format(date); // 2000-05-31
String yyyymmdd = date.format(DateTimeFormatter.ISO_LOCAL_DATE); // 2000-05-31

🔎 DateTimeFormatter에 상수로 정의된 몇가지 형식

DateTimeFormatter	보기
ISO_DATE_TIME	2023-08-13T10:15:30+01:00[Europe/Paris]
ISO_LOCAL_DATE	2023-08-13
ISO_LOCAL_TIME	10:15:30
ISO_LOCAL_DATE_TIME	2023-08-13T10:15:30
BASIC_ISO_DATE	20230813
RFC_1123_DATE_TIME	Sun, 13 Aug 2023 10:15:30 GMT

 

✔️ 로케일에 종속된 형식화

DateTimeFormatter formatter = DateTimeFormatter.ofLocalizedDate(FormatStyle.SHORT);
String shortFormat = formatter.format(LocalDate.now()); // 23.08.13

🔎 열거형 FormatStyle에 정의된 상수

FormatStyle	날짜	시간
FULL	2023년 8월 13일 일요일	N/A
LONG	2023년 8월 13일 (일)	오후 9시 15분 13초
MEDIUM	2023.8.13	오후 9:15:13
SHORT	23.8.13일	오후 9:15

 

✔️ 출력형식 직접 정의하기

: DateTimeFormatter의 ofPattern()으로 원하는 출력을 직접 작성할 수도 있음

LocalDateTime dateTime = LocalDateTime.now();
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy.mm.dd HH:mm");
dateTime.format(formatter); // 2023.08.13 01:26

❕ 패턴에 사용되는 기호는 필요할 때 찾아보기!

 

✔️ 문자열을 날짜와 시간으로 파싱하기

: static 메서드인 parse()를 이용하면 문자열 → 날짜 또는 시간 변환 가능!

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy.mm.dd HH:mm");
LocalDateTime dateTime = LocalDateTime.parse("2023.08.13 01:29", pattern);

❕ 자주 사용되는 기본적인 형식의 문자열은 형식화 상수없이 파싱 가능!

LocalDate date = LocalDate.parse("2023-08-13");