Xamarin.Forms中使用Akavache如何避免UTC转换并保留本地时区？

Akavache默认依赖Newtonsoft.Json，其默认配置会将DateTime自动转换为UTC存储，这就是你遇到问题的根源。以下是几个高效的解决方案，无需遍历集合手动转换：

方案1：全局配置Akavache的Json序列化设置，禁用UTC转换 #

修改Akavache使用的JsonSerializerSettings，让它保留原始DateTime的时区信息，从根源上解决问题：

// 在App启动阶段（如App.xaml.cs的OnStart方法）执行配置
var jsonSettings = new JsonSerializerSettings
{
    DateTimeZoneHandling = DateTimeZoneHandling.Local, // 强制保留本地时区
    DateParseHandling = DateParseHandling.DateTime
};

// 替换Akavache的默认序列化器
BlobCache.ApplicationName = "YourAppName";
BlobCache.LocalMachine = new SQLitePersistentBlobCache(
    BlobCache.LocalMachine.DbPath,
    new NewtonsoftJsonSerializer(jsonSettings)
);

配置完成后，所有DateTime类型的数据在存储和取回时都会保留原始本地时区，不会自动转UTC。

方案2：使用DateTimeOffset替代DateTime存储 #

DateTimeOffset本身包含时区偏移信息，Akavache处理该类型时不会进行UTC转换。只需将模型中的DateTime字段替换为DateTimeOffset：

// 原模型
public class RecordModel
{
    public DateTime CreateTime { get; set; }
}

// 修改后模型
public class RecordModel
{
    public DateTimeOffset CreateTime { get; set; }
}

存储和读取时直接使用DateTimeOffset，它会完整保留原始的时区信息，无需额外转换操作。

方案3：为特定DateTime字段自定义Json转换器 #

如果仅需针对部分DateTime字段保留时区，可为这些字段单独添加自定义转换器：

public class RecordModel
{
    [JsonConverter(typeof(LocalDateTimePreserveConverter))]
    public DateTime CreateTime { get; set; }
}

// 自定义转换器实现
public class LocalDateTimePreserveConverter : DateTimeConverterBase
{
    public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
    {
        if (reader.Value is DateTime dt)
        {
            return dt.ToLocalTime();
        }
        return base.ReadJson(reader, objectType, existingValue, serializer);
    }

    public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer)
    {
        if (value is DateTime dt)
        {
            writer.WriteValue(dt);
        }
        else
        {
            base.WriteJson(writer, value, serializer);
        }
    }
}

方案选择建议 #

• 方案1是全局生效的最优解，无需修改现有模型，一次性配置即可解决所有DateTime的时区转换问题。
• 方案2更推荐用于新项目，DateTimeOffset本身就是为带时区的时间场景设计，能避免时区歧义。
• 所有方案都无需遍历集合手动转换，性能开销可忽略不计。

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