📅 날짜와 시간에 대해서 🕛

🗣 프로필 수정시에 가끔 날짜가 바뀝니다

---

동료 분께서 리포팅을 해주셨는데
프로필 수정 시에 날짜가 간혈적으로
다르게 셋팅 되어 있다는 제보였습니다.

상황을 들어보니 시간에 따라서 발생하는 것 같아
의심가는 상황으로 재현을 해보니 성공 했습니다.

2024년 1월 1일 생일 > 프로필 수정 > 🐛 2023년 12월 31일?!

📅 날짜 구현 시

서버는 ISO8601 형식으로 날짜를 내려주고
앱은 Material3 > DatePickerDialog 로 구현 했습니다.

DatePickerDialog 구현 시
컴포즈답게 데이터는 상태로 관리하는데요.

rememberDatePickerState로
연도 날짜를 설정할 수 있습니다.

프로필 수정 시 > 기존의 데이터가 존재하므로
initialSelectedDateMillis: Long 의
데이터를 보고 Calandar로 파싱 후
time을 넘겼었습니다.

🕕 국제 표준과 API의 이해

---

위의 상황을 이해하기 위해서
rememberDatePickerState를 이해했어야 했습니다.
(정확히는 initialSelectedDateMillis 파라미터)

아래는 해당 함수의 주석입니다.

해당 주석을 보고 timestamp, UTC, epoch에 대해
생소해서 쉽게 이해할 수 없었습니다.

그래서 날짜와 시간에 대해서
이해한 내용을 정리하고자 합니다.

🤝 UTC

협정 세계시(協定世界時, 영어: Coordinated Universal Time/Universal Time Coordinated, UTC)는 1972년 1월 1일부터 시행된 ✌🏻국제 표준시✌🏻

📌 UTC 표기 방법

2024-03-30T09:00Z 또는 20240330T0900Z

• UTC 시간대에서의 2024년 3월 30일 오전 9시
• Z는(Zulu) UTC 시간을 나타내는 축약문자열
  • Z 붙어 있으면 해당 시간은 UTC 기준
• T는 ISO-8601 형식에서 시간사이의 구분자(Delimiter for the time)

👨🏻‍💻 API(Java) 에 대한 이해

우선 큰 틀에서 다음과 같이 나누고자 합니다.

• 사람이 이해하기 쉬운
  • LocalDate, LocalTime, LocalDateTime, ZonedDateTime
• 기계가 이해하기 쉬운
  • Instant(타임스탬프)

💁🏻 사람이 이해하기 쉬운 API

링크한 문서의 링크로 가시면
다음과 같은 공통점과 차이점이 존재합니다.

공통점

• ISO8601 calendar system 에 의거한다.
• immutable 하다.
• thread-safe 하다.
• 시간을 유용하게 다를 수 있다.

차이점

• time-zone 포함 여부

여기서 시간에 대해 이해가 조금 더 필요 합니다.
현재 한국의 시간과 파리의 시간이 동일한가요?
그렇지 않습니다.

한국은 UTC를 기준으로 +9 시간(오프셋)을 하면 한국 시간입니다.

파리는 +1 시간(오프셋)을 하면 되지만
해당 국가는 Summer Time이 존재 합니다.
이 때는 +2시간의(오프셋) 적용 됩니다.
그래서 파리는 시간(오프셋)을 더하는 것보다 > 지역ID에 따라 처리 > TimeZoneId

위의 내용을 정리해보면 Time API 에서

• 고정된 시간이라면 오프셋 > ZoneOffset 으로 처리 가능
• 서머 타임과 같은 복잡한 시간 계산의 경우 > TimeZoneId 처리 가능

그러면 ZoneId 와 ZoneOffset 은 같은 개념은 아니지만
국가별 시간 처리를 위해서는
ZoneId를 포괄하는 개념으로
유연하게 처리할 수 있겠습니다.

ZoneId 는 💁🏻 TimeZones.html 에서 볼 수 있습니다.

시간에 대한 개념은 이 정도로 정리하고
이제 API를 언제 사용해야할지
사용하는 법을 정리해보겠습니다.

우선 끊어서 이해하면 조금 더 직관적입니다.

• Local - 타임존 개념이 필요없는 Local 정보
• Date - 날짜
• Time - 시간
• DateTime - 날짜+시간
• Zoned - 타임존 개념이 필요한

붙여서 보면 이제 이해가 됩니다.

• LocalDate: 타임존 개념이 필요없는 날짜 설정 관련 API
• LocalTime: 타임존 개념이 필요없는 시간 설정 관련 API
• LocalDateTIme: 타임존 개념이 필요없는 Date + Time API
• ZonedDateTime: 타임존 개념이 필요한 Date + Time API

위의 API들은 시간/날짜 처리 및 파싱을 우리가 사용하기 쉽게 제공을 해줍니다.
크게 생성, 읽기, 조작, 변경으로 볼 수 있을 것 같습니다.

📌 생성

• now(), of()를 통해 생성이 가능

fun main() {
    val localDateTime = LocalDateTime.now(ZoneId.systemDefault())
    println("localDateTime: $localDateTime")

    val localTime = LocalTime.now()
    println("localTime: $localTime")

    val zonedDateTime = ZonedDateTime.now()
    println("zonedDateTIme: $zonedDateTime")

    val myBirthDateTime = Year.of(1991).atMonth(12).atDay(2).atTime(20,0)
    println("myBirthDateTime: $myBirthDateTime")
}

// result
localDateTime: 2024-04-07T18:43:17.322065
localTime: 18:43:17.326843
zonedDateTIme: 2024-04-07T18:43:17.327536+09:00[Asia/Seoul]
myBirthDateTime: 1991-12-02T20:00

📌 읽기

• get 으로 시작하는 함수 > 연도, 날짜, 시간, 요일 등등

fun main() {
    val localDateTime = LocalDateTime.now(ZoneId.systemDefault())
    println("localDateTime > get Time: ${localDateTime.hour}")

    val localTime = LocalTime.now()
    println("localTime > get Minute: ${localTime.minute}")

    val myBirthDate = Year.of(1991).atMonth(12).atDay(2).atTime(20,0)
    val currentZonedDateTime = ZonedDateTime.now()
    println("zonedDateTIme > DayOfWeek : ${currentZonedDateTime.dayOfWeek}")
    println("zonedDateTime > is After myBirthDate : ${currentZonedDateTime.isAfter(myBirthDate.atZone(ZoneId.systemDefault()))}")
}


// result
localDateTime > get Time: 18
localTime > get Minute: 55
currentZonedDateTime > DayOfWeek : SUNDAY
currentZonedDateTime > is After myBirthDate : true

📌 조작

• plus, minus 함수를 통해서 시간 날짜 등을 쉽게 변경 가능

📌 변경(파싱)

• parse() 와 format() 를 통해 파싱 가능

fun main() {
    val currentDateTimeUTC = "2024-03-30T20:20:20Z"
    val parsedZonedDateTime = utcToZonedDateTime(currentDateTimeUTC)
    val korZonedDateTime = parsedZonedDateTime.withZoneSameInstant(ZoneId.systemDefault())
    println("korZonedDateTime: $korZonedDateTime") 
    
    // 원하는 포맷으로 설정
    val fullLocalDateTimeFormatter = DateTimeFormatter.ofLocalizedDateTime(FormatStyle.FULL)
    println("korZonedDateTimeFullFormat: ${korZonedDateTime.format(fullLocalDateTimeFormatter)}")

}

private fun utcToZonedDateTime(utcTime: String): ZonedDateTime {
    return ZonedDateTime.parse(utcTime)
}


// 결과
korZonedDateTime: 2024-03-31T05:20:20+09:00[Asia/Seoul]
korZonedDateTimeFullFormat: 2024년 3월 31일 일요일 오전 5시 20분 20초 대한민국 표준시

• 날짜와 시간의 포맷을 지정하여 파싱

fun main() {
    val currentDateTimeUTC = "2024-03-30T20:20:20Z"
    val systemZonedDateTime = utcToSystemZonedDateTime(currentDateTimeUTC)
    println("systemZonedDateTime: $systemZonedDateTime")

    val formatter = DateTimeFormatter.ofLocalizedDateTime(FormatStyle.LONG, FormatStyle.SHORT) // Here 📌
    println("koreaStyleZonedDateTime: ${systemZonedDateTime.format(formatter)}")
}



private fun utcToSystemZonedDateTime(utcTime: String): ZonedDateTime {
    val instant = Instant.parse(utcTime)
    return ZonedDateTime.ofInstant(instant, ZoneId.systemDefault())
}


// 결과
systemZonedDateTime: 2024-03-31T05:20:20+09:00[Asia/Seoul]
koreaStyleZonedDateTime: 2024년 3월 31일 오전 5:20

💁🏻 Instant API

This class models a single instantaneous point on the time-line. This might be used to record event time-stamps in the application

위의 설명을 보면 Instant 클래스는
애플리케이션에서 시간을 타임스탬프로 다루기 위해서
사용되는 API 라고 되어있습니다.

위에 epoch 라는 개념이 여기서 등장하는데요

The epoch-seconds are measured from the standard Java epoch of 1970-01-01T00:00:00Z where instants after the epoch have positive values, and earlier instants have negative values.

설명을 보면 1970-01-01T00:00:00Z(Z가 붙은걸로 봐서 UTC 기준)로부터
측정되는 것을 epoch-seconds 라고 합니다.

코드로 보면 아래와 같은 형태로 출력 됩니다.

fun main() {
    val utcLong: Long = 1711830020
    val utcTime = Instant.ofEpochSecond(utcLong)
    println("utc Long($utcLong) to Instant > $utcTime")
    
    val epoch = utcTime.epochSecond
    println("Instant.epoch: $epoch")
}

// 결과
utc Long(1711830020) to Instant > 2024-03-30T20:20:20Z
Instant.epoch: 1711830020

여기까지 각 API에 대해서 이해한 것을 바탕으로
최대한 쉽게 설명해 보았습니다.

💡 다시 코드로 돌아가서

컴포즈 파라미터의 주석을 다시 보면 이제는 이해가 갑니다 ⭐️

// @param initialSelectedDateMillis timestamp in _UTC_ milliseconds from the epoch

timestamp > Instant 의 milliseconds epoch 로 값을 전달하라는 의미였습니다.

그래서 해결은
1 Instant 클래스로 변환 후
2 .toEpochMilli()
전달하여 해결 됐습니다.

👏🏻 포스트를 마치며

DatePicker로 시작하여
Date 와 Time 에 대해서
꽤 큰 범위를 공부해보고 정리까지 해봤는데
실수로 부터 많은 것을 배운 계기가 되었습니다.

피드백은 언제나 환영이며 🙇🏻
이만 마치겠습니다.