[Kotlin] 날짜와 시간 클래스

💡 코틀린에서 날짜와 시간을 다루는 클래스에 대하여 학습하였습니다! Java의 API와 Kotlin 자체 라이브러리를 비교하였습니다.

 

Java API

• Kotlin은 JVM 언어이기 때문에 Java의 날짜 및 시간 API를 직접 사용할 수 있습니다.
• Java 8에서 도입된 java.time 패키지의 API를 많이 사용합니다.

java.time 패키지

• Java 8에서 도입된 날짜와 시간 관련 API로, 현대적인 방식으로 날짜와 시간을 처리할 수 있게 해줍니다.
  • [LocalDate] : 날짜(년, 월, 일)을 표현하는 클래스
  • [LocalTime] : 시간(시, 분, 초, 나노초) 을 표현하는 클래스
  • [LocalDateTime] : 날짜와 시간 모두 표현하는 클래스
  • [Period] : 두 날짜 간의 차이를 표현하는 클래스
  • [Duration] : 두 시간 간의 차이를 표현하는 클래스
• 이 이외에도 시간대 정보를 표현하는 ZonedDateTime이 있습니다.

import java.time.LocalDate
import java.time.LocalTime
import java.time.LocalDateTime
import java.time.format.DateTimeFormatter

fun main() {
    val currentDate = LocalDate.now()
    val currentTime = LocalTime.now()
    val currentDateTime = LocalDateTime.now()

    val formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")

    println("현재 날짜: $currentDate")
    println("현재 시간: $currentTime")
    println("현재 날짜와 시간: ${currentDateTime.format(formatter)}")
}

Calendar

• Java 8 이전에는 java.util.Date와 java.util.Calendar 클래스를 사용하여 날짜와 시간을 처리하였습니다.
• 하지만 위 클래스들은 설계상의 문제로 인해 사용이 번거로워 구식 API로 간주되고 있습니다.

import java.util.Date
import java.util.Calendar

fun main() {
    val date = Date() // 현재 날짜와 시간을 가져옴
    val calendar = Calendar.getInstance()
    
    println("현재 날짜와 시간 (Date): $date")
    println("현재 날짜와 시간 (Calendar): ${calendar.time}")
}

java.util.Date와 java.util.Calendar 문제점

• 위 클래스들은 Java의 초기 버전에 날짜와 시간을 처리하기 위해 도입된 클래스입니다.
• 이 클래스를 사용하면서 아래와 같은 문제점이 발생할 수 있습니다.
  • [불변성] : 두 클래스 다 변경 간으한 객체를 생성하므로, 멀티 스레드 환경에서 문제를 일으킬 수 있습니다.
  • [API 설계] : 두 클래스의 API는 직관적이지 않고 사용하기 어렵습니다.
    • ex> 월은 0월부터 시작하며, 1월이 0, 12월이 11

Kotlin 라이브러리

• 코틀린에서는 자체적으로 날짜와 시간을 처리하기 위한 kotlinx-datetime 라이브러리를 제공합니다.
• 이 라이브러리는 Kotlin Multiplatform 프로젝트에서도 사용할 수 있으며, java.time과 유사한 구조를 가지고 있습니다.

kotlinx-datetime 패키지

• [LocalDate] : 날짜(년, 월, 일)를 표현하는 클래스
• [LocalDateTime] : 날짜와 시간을 모두 표현하는 클래스
• [Instant] : 특정 시점을 나타내는 클래스
• [TimeZone] : 시간대를 나타내는 클래스

kotlinx-datetime 의존성 추가

• kotlinx-datetime 라이브러리를 활용하기 위해서는 Gradle 파일에 의존성을 추가해야 합니다.

dependencies {
    implementation("org.jetbrains.kotlinx:kotlinx-datetime:0.4.0")
}

kotlinx-datetime 활용하기

import kotlinx.datetime.*

fun main() {
    // 현재 날짜와 시간 가져오기
    val currentDate = LocalDate.now()
    val currentDateTime = LocalDateTime.now()

    // 현재 시간대를 사용하여 특정 시점(Instant) 생성
    val currentInstant = Clock.System.now()

    // 현재 시스템의 시간대 가져오기
    val currentZone = TimeZone.currentSystemDefault()

    // Instant를 LocalDateTime으로 변환 (현재 시간대)
    val localDateTimeFromInstant = currentInstant.toLocalDateTime(currentZone)

    // UTC 시간대로 변환
    val utcZone = TimeZone.UTC
    val utcDateTime = currentInstant.toLocalDateTime(utcZone)

    // 출력
    println("현재 날짜: $currentDate")
    println("현재 시간: $currentDateTime")
    println("현재 시점 (Instant): $currentInstant")
    println("현재 시점에서의 LocalDateTime: $localDateTimeFromInstant")
    println("UTC 시간대에서의 LocalDateTime: $utcDateTime")
}

정리

• Kotlin에서 날짜와 시간을 처리할 때 Java의 java.time API를 활용할 수 있습니다.
• Kotlin 특화 라이브러리인 kotlinx-datetime을 사용할 수 있습니다.
• 프로젝트의 요구사항과 플랫폼(Android, JVM, Multiplatform 등)에 따라 적절하게 사용해야 합니다 !

참고

https://kotlinworld.com/57