如何让含LocalDate/LocalDateTime的数据类在Jetpack Compose中稳定？

问题根源 #

java.time.LocalDate 和 kotlinx.datetime.LocalDateTime 属于第三方不可变类型，但Compose的稳定性检查器默认无法识别这类类型的结构相等性与不可变性，因此包含这些字段的数据类会被整体标记为不稳定，影响Compose的重组优化效果。

解决方案：自定义稳定包装类 #

通过给日期时间类型套一层Compose可识别的稳定包装类，让数据类符合Compose的稳定性要求。有两种实现方式，按需选择：

1. 轻量值类型包装（推荐）

利用Kotlin的value class实现无额外开销的包装，同时添加@Immutable注解明确标记稳定性：

import androidx.compose.runtime.Immutable
import kotlinx.datetime.LocalDateTime
import java.time.LocalDate

// 包装kotlinx.datetime.LocalDateTime
@Immutable
@JvmInline
value class StableLocalDateTime(val value: LocalDateTime) {
    // 按需委托原类型的方法，避免每次手动取value
    fun format(formatter: kotlinx.datetime.DateTimeFormatter): String = value.format(formatter)
    fun toEpochMilliseconds(): Long = value.toEpochMilliseconds()
}

// 包装java.time.LocalDate
@Immutable
@JvmInline
value class StableLocalDate(val value: LocalDate) {
    fun format(formatter: java.time.format.DateTimeFormatter): String = value.format(formatter)
}

2. 常规数据类包装

如果需要更灵活的扩展（比如添加自定义逻辑），可以用普通数据类配合@Immutable注解：

import androidx.compose.runtime.Immutable
import kotlinx.datetime.LocalDateTime

@Immutable
data class StableLocalDateTime(val value: LocalDateTime) {
    // 自定义扩展方法示例
    fun isPast(): Boolean = value < kotlinx.datetime.Clock.System.now()
}

数据类中使用稳定包装类 #

将原日期时间字段替换为自定义的稳定类型，数据类会自动被Compose识别为稳定类：

data class CalendarEvent(
    val id: String,
    val title: String,
    val date: StableLocalDate,
    val startTime: StableLocalDateTime
)

关键说明 #

• @Immutable注解是@Stable的严格版本，适用于完全不可变的类型，这里的包装类内部持有不可变的日期时间实例，符合该注解的要求。
• 包装类的equals和hashCode默认基于内部值实现（数据类/value class自动生成），保证结构相等性的判断逻辑正确。

内容的提问来源于stack exchange，提问作者beigirad