能否在Kotlin Realm SDK中存储Java LocalDateTime等自定义数据类型？

首先明确：Realm Kotlin SDK不直接支持java.time.LocalDateTime/LocalDate等类型，但可以通过自定义转换器或Kotlin序列化器实现，且能大幅减少你当前的样板代码。

方案1：使用Realm官方的@PersistedConverter（推荐，SDK 1.10.0+） #

Realm 1.10.0及以上版本支持自定义持久化转换器，只需实现RealmConverter接口，然后在属性上标记注解即可，无需手动维护私有字段和get/set方法。

步骤1：实现转换器类 #

针对LocalDateTime和LocalDate分别实现转换逻辑：

import io.realm.kotlin.types.RealmConverter
import io.realm.kotlin.types.RealmInstant
import java.time.LocalDateTime
import java.time.LocalDate
import java.time.ZoneOffset

// LocalDateTime <-> RealmInstant 转换器
object LocalDateTimeConverter : RealmConverter<LocalDateTime, RealmInstant> {
    override fun convertToRealmValue(value: LocalDateTime): RealmInstant {
        return value.toInstant(ZoneOffset.UTC).toRealmInstant()
    }

    override fun convertFromRealmValue(value: RealmInstant): LocalDateTime {
        return LocalDateTime.ofInstant(value.toInstant(), ZoneOffset.UTC)
    }
}

// LocalDate <-> RealmInstant 转换器
object LocalDateConverter : RealmConverter<LocalDate, RealmInstant> {
    override fun convertToRealmValue(value: LocalDate): RealmInstant {
        return value.atStartOfDay(ZoneOffset.UTC).toInstant().toRealmInstant()
    }

    override fun convertFromRealmValue(value: RealmInstant): LocalDate {
        return LocalDate.ofInstant(value.toInstant(), ZoneOffset.UTC)
    }
}

步骤2：在RealmObject中使用 #

直接定义java.time类型属性，加上@PersistedConverter注解即可：

import io.realm.kotlin.types.RealmObject
import io.realm.kotlin.types.annotations.PersistedConverter
import java.time.LocalDate
import java.time.LocalDateTime

class Task : RealmObject {
    // LocalDateTime类型属性
    @PersistedConverter(converter = LocalDateTimeConverter::class)
    var scheduledTime: LocalDateTime = LocalDateTime.now()

    // LocalDate类型属性
    @PersistedConverter(converter = LocalDateConverter::class)
    var dayScheduled: LocalDate = LocalDate.now()
}

这个方案完全替代了你当前的私有字段+get/set写法，代码更简洁，转换逻辑集中可复用。

方案2：使用Kotlin Serialization的KSerializer #

如果项目已集成Kotlin Serialization，也可以通过自定义KSerializer处理转换，不过需要额外配置Realm的序列化支持。

示例：自定义LocalDate的KSerializer #

import io.realm.kotlin.types.RealmInstant
import kotlinx.serialization.KSerializer
import kotlinx.serialization.descriptors.PrimitiveKind
import kotlinx.serialization.descriptors.PrimitiveSerialDescriptor
import kotlinx.serialization.descriptors.SerialDescriptor
import kotlinx.serialization.encoding.Decoder
import kotlinx.serialization.encoding.Encoder
import java.time.LocalDate
import java.time.ZoneOffset

object LocalDateSerializer : KSerializer<LocalDate> {
    override val descriptor: SerialDescriptor =
        PrimitiveSerialDescriptor("LocalDate", PrimitiveKind.STRING)

    override fun serialize(encoder: Encoder, value: LocalDate) {
        val realmInstant = value.atStartOfDay(ZoneOffset.UTC).toInstant().toRealmInstant()
        encoder.encodeString(realmInstant.toString())
    }

    override fun deserialize(decoder: Decoder): LocalDate {
        val realmInstantString = decoder.decodeString()
        val realmInstant = RealmInstant.from(realmInstantString)
        return LocalDate.ofInstant(realmInstant.toInstant(), ZoneOffset.UTC)
    }
}

在RealmObject中使用 #

需确保Realm配置启用Kotlin Serialization：

import io.realm.kotlin.Realm
import io.realm.kotlin.RealmConfiguration
import kotlinx.serialization.Serializable

@Serializable
class Task : RealmObject {
    @Serializable(with = LocalDateSerializer::class)
    var dayScheduled: LocalDate = LocalDate.now()
}

// Realm配置示例
val config = RealmConfiguration.Builder(schema = setOf(Task::class))
    .serializerFactory(kotlinx.serialization.json.Json)
    .build()
val realm = Realm.open(config)

这种方案适合本身依赖Kotlin Serialization的项目，但配置步骤比@PersistedConverter繁琐。

对比你当前的实现 #

你当前的写法需要手动维护私有字段和get/set方法，代码冗余且不易复用。上面两种方案都将转换逻辑抽离，属性定义更直观，后续修改转换规则只需调整转换器/序列化器即可。

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