날짜와 시간 — java.time으로 날짜 다루기

LocalDate       — 날짜만 (2026-03-19)
LocalTime       — 시간만 (14:30:00)
LocalDateTime   — 날짜 + 시간 (2026-03-19T14:30:00)

// 직관적인 API
LocalDate date = LocalDate.of(2026, 3, 19); // 2026년 3월 19일. 그냥 3이 3월이다!
LocalTime time = LocalTime.of(14, 30);       // 오후 2시 30분
LocalDateTime dateTime = LocalDateTime.of(date, time); // 조합

// now() — 현재 시간
LocalDate today = LocalDate.now();           // 오늘 날짜
LocalTime now = LocalTime.now();             // 현재 시각
LocalDateTime current = LocalDateTime.now(); // 현재 날짜+시간

// of() — 직접 지정
LocalDate birthday = LocalDate.of(1995, 8, 15);
LocalDate sameDay = LocalDate.of(1995, Month.AUGUST, 15); // enum 사용 가능

// parse() — 문자열에서 생성
LocalDate parsed = LocalDate.parse("2026-03-19");
LocalTime parsedTime = LocalTime.parse("14:30:00");

LocalDate today = LocalDate.of(2026, 3, 19);

// 더하기
LocalDate nextWeek = today.plusDays(7);      // 2026-03-26
LocalDate nextMonth = today.plusMonths(1);    // 2026-04-19
LocalDate nextYear = today.plusYears(1);      // 2027-03-19

// 빼기
LocalDate lastWeek = today.minusDays(7);     // 2026-03-12
LocalDate lastMonth = today.minusMonths(1);  // 2026-02-19

// 특정 값으로 변경
LocalDate withDay = today.withDayOfMonth(1); // 2026-03-01 (이번 달 1일)
LocalDate withMonth = today.withMonth(12);   // 2026-12-19

// 원본은 그대로다!
System.out.println(today); // 2026-03-19 — 변하지 않음

LocalDate date1 = LocalDate.of(2026, 3, 19);
LocalDate date2 = LocalDate.of(2026, 12, 25);

// 비교
boolean isBefore = date1.isBefore(date2); // true
boolean isAfter = date1.isAfter(date2);   // false
boolean isEqual = date1.isEqual(date2);   // false

// 유용한 판단 메서드
boolean isLeapYear = date1.isLeapYear();        // false (2026년은 윤년 아님)
int lengthOfMonth = date1.lengthOfMonth();       // 31 (3월은 31일)
DayOfWeek dayOfWeek = date1.getDayOfWeek();      // THURSDAY

// 두 날짜 사이의 간격
LocalDate start = LocalDate.of(2024, 1, 1);
LocalDate end = LocalDate.of(2026, 3, 19);

Period period = Period.between(start, end);
System.out.println(period); // P2Y2M18D (2년 2개월 18일)
System.out.println(period.getYears());  // 2
System.out.println(period.getMonths()); // 2
System.out.println(period.getDays());   // 18

// 직접 생성
Period oneYearThreeMonths = Period.of(1, 3, 0);  // 1년 3개월
Period twoWeeks = Period.ofWeeks(2);              // 14일

// 날짜에 적용
LocalDate future = start.plus(oneYearThreeMonths); // 2025-04-01

// 두 시간 사이의 간격
LocalTime morning = LocalTime.of(9, 0);
LocalTime evening = LocalTime.of(18, 30);

Duration workHours = Duration.between(morning, evening);
System.out.println(workHours);            // PT9H30M (9시간 30분)
System.out.println(workHours.toHours());  // 9
System.out.println(workHours.toMinutes()); // 570

// 직접 생성
Duration twoHours = Duration.ofHours(2);
Duration thirtyMinutes = Duration.ofMinutes(30);
Duration fiveSeconds = Duration.ofSeconds(5);

// 시간에 적용
LocalTime lunchEnd = morning.plus(Duration.ofHours(4)); // 13:00

LocalDateTime now = LocalDateTime.of(2026, 3, 19, 14, 30, 0);

// 기본 포맷터 사용
String isoDate = now.format(DateTimeFormatter.ISO_LOCAL_DATE);       // 2026-03-19
String isoDateTime = now.format(DateTimeFormatter.ISO_LOCAL_DATE_TIME); // 2026-03-19T14:30:00

// 커스텀 포맷터 생성
DateTimeFormatter korean = DateTimeFormatter.ofPattern("yyyy년 MM월 dd일 HH시 mm분");
DateTimeFormatter slash = DateTimeFormatter.ofPattern("yyyy/MM/dd");
DateTimeFormatter simple = DateTimeFormatter.ofPattern("yy.MM.dd");

LocalDateTime now = LocalDateTime.of(2026, 3, 19, 14, 30, 0);

// 포맷팅 — 날짜 → 문자열
System.out.println(now.format(korean)); // 2026년 03월 19일 14시 30분
System.out.println(now.format(slash));  // 2026/03/19
System.out.println(now.format(simple)); // 26.03.19

// 파싱 — 문자열 → 날짜
LocalDate parsed = LocalDate.parse("2026/03/19", slash);
System.out.println(parsed); // 2026-03-19

// 이렇게 써도 안전하다 — DateTimeFormatter는 불변
public class DateUtils {
    private static final DateTimeFormatter FORMATTER =
        DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");

    public static String format(LocalDateTime dateTime) {
        return dateTime.format(FORMATTER); // 멀티스레드 안전
    }
}

// 타임존을 지정해서 생성
ZonedDateTime seoulTime = ZonedDateTime.now(ZoneId.of("Asia/Seoul"));
ZonedDateTime nyTime = ZonedDateTime.now(ZoneId.of("America/New_York"));

System.out.println(seoulTime); // 2026-03-19T14:30:00+09:00[Asia/Seoul]
System.out.println(nyTime);    // 2026-03-19T01:30:00-04:00[America/New_York]

// 같은 시점이지만 표현이 다르다
System.out.println(seoulTime.isEqual(nyTime)); // true — 같은 순간

// 타임존 변환
ZonedDateTime tokyoTime = seoulTime.withZoneSameInstant(ZoneId.of("Asia/Tokyo"));
// 서울과 도쿄는 같은 시간대라 시간이 같다

// LocalDateTime에 타임존 부여
LocalDateTime local = LocalDateTime.of(2026, 3, 19, 14, 30);
ZonedDateTime zoned = local.atZone(ZoneId.of("Asia/Seoul"));

// 오프셋 지정
OffsetDateTime odt = OffsetDateTime.of(
    LocalDateTime.of(2026, 3, 19, 14, 30),
    ZoneOffset.of("+09:00")
);
System.out.println(odt); // 2026-03-19T14:30+09:00

// UTC로 변환
OffsetDateTime utc = odt.withOffsetSameInstant(ZoneOffset.UTC);
System.out.println(utc); // 2026-03-19T05:30Z

// 현재 타임스탬프
Instant now = Instant.now();
System.out.println(now); // 2026-03-19T05:30:00.123456789Z (항상 UTC)

// epoch 초로 생성
Instant fromEpoch = Instant.ofEpochSecond(1_774_000_000L);
Instant fromMilli = Instant.ofEpochMilli(System.currentTimeMillis());

// 비교
long secondsBetween = Duration.between(fromEpoch, now).getSeconds();

// Instant → ZonedDateTime (타임존 부여)
ZonedDateTime zdt = now.atZone(ZoneId.of("Asia/Seoul"));

// JPA 엔티티 예시
@Entity
public class Order {
    // 주문 시각 — 타임존이 중요하다면 Instant
    @Column(name = "ordered_at")
    private Instant orderedAt;

    // 배송 예정일 — 날짜만 필요
    @Column(name = "delivery_date")
    private LocalDate deliveryDate;

    // 영업 시작 시간 — 시간만 필요
    @Column(name = "open_time")
    private LocalTime openTime;
}

// Jackson에서 java.time 지원을 위한 의존성
// build.gradle: implementation 'com.fasterxml.jackson.datatype:jackson-datatype-jsr310'

// ObjectMapper 설정
ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(new JavaTimeModule());
mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS); // ISO 형식으로 출력

// DTO에서 포맷 지정
public class EventDto {
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private LocalDateTime startTime;

    @JsonFormat(pattern = "yyyy-MM-dd")
    private LocalDate eventDate;
}

// Date → Instant → LocalDateTime
Date legacyDate = new Date();
Instant instant = legacyDate.toInstant();
LocalDateTime ldt = LocalDateTime.ofInstant(instant, ZoneId.systemDefault());

// LocalDateTime → Instant → Date
LocalDateTime localDateTime = LocalDateTime.of(2026, 3, 19, 14, 30);
Instant toInstant = localDateTime.atZone(ZoneId.systemDefault()).toInstant();
Date backToDate = Date.from(toInstant);

// Calendar → Instant
Calendar calendar = Calendar.getInstance();
Instant fromCal = calendar.toInstant();
ZonedDateTime fromCalZoned = fromCal.atZone(calendar.getTimeZone().toZoneId());

Date ──toInstant()──→ Instant ──atZone()──→ ZonedDateTime ──toLocalDateTime()──→ LocalDateTime
                         ↑
Calendar ──toInstant()───┘

LocalDateTime ──atZone()──→ ZonedDateTime ──toInstant()──→ Instant ──Date.from()──→ Date