default··约 5 分钟读完·450 次观看

Rust 中的日期时间序列化:将 UTC 转换为北京时间

Rust后端开发中处理时区转换的实用技巧:通过SeaORM模型和自定义序列化函数,将UTC时间转换为北京时间并格式化输出。文章分析了核心代码结构,包括时区转换函数和自定义序列化实现,重点讲解了Serde自定义序列化、OpenAPI集成和时区处理等关键技术。这种方案既能保证数据库存储一致性,又能提供符合用户习惯的本地时间显示,适用于中文用户界面、国际化应用和日志审计等场景,展示了Rust在类型安全和灵活性方面的优势。
大数据rust开发语言

Rust 中的日期时间序列化:将 UTC 转换为北京时间

在 Rust 后端开发中,处理日期时间并确保其在 API 响应中以正确的时区显示是一个常见需求。本文将基于提供的代码示例,探讨如何在 SeaORM 模型中使用自定义序列化函数,将 UTC 时间转换为北京时间并格式化输出。

代码结构分析

首先,让我们看一下主要的 Model 结构体:

rust
      
        
          1
          
          #[derive(Clone, Debug, PartialEq, DeriveEntityModel, Eq, Serialize, Deserialize, ToSchema)]
        
          2
          
          #[sea_orm(table_name = "categories")]
        
          3
          
          pub struct Model {
        
          4
          
              #[sea_orm(primary_key)]
        
          5
          
              pub id: i32,
        
          6
          
              pub name: String,
        
          7
          
              #[sea_orm(unique)]
        
          8
          
              pub slug: String,
        
          9
          
              #[sea_orm(column_type = "Text", nullable)]
        
          10
          
              pub description: Option<String>,
        
          11
          
              #[schema(value_type = String, format = DateTime)]
        
          12
          
              #[serde(serialize_with = "fmt_beijing")]
        
          13
          
              pub created_at: DateTimeUtc,
        
          14
          
              #[schema(value_type = String, format = DateTime)]
        
          15
          
              #[serde(serialize_with = "fmt_beijing")]
        
          16
          
              pub updated_at: DateTimeUtc,
        
          17
          
          }
        
      
    

这个结构体表示一个分类(category)实体,包含 ID、名称、唯一标识符(slug)、描述以及创建和更新时间字段。

核心功能:时区转换与格式化

时区转换函数

rust
      
        
          1
          
          use chrono::{DateTime, FixedOffset, Utc};
        
          2
          
          
        
          3
          
          /// UTC -> 北京时间 (+8)
        
          4
          
          fn to_beijing(dt: DateTime<Utc>) -> DateTime<FixedOffset> {
        
          5
          
              let beijing = FixedOffset::east_opt(8 * 3600).unwrap();
        
          6
          
              dt.with_timezone(&beijing)
        
          7
          
          }
        
      
    

这个函数将 UTC 时间转换为北京时间(东八区)。它使用 FixedOffset 创建一个 +8 小时的时区偏移,然后使用 with_timezone 方法进行转换。

自定义序列化函数

rust
      
        
          1
          
          /// 序列化函数:2025-09-24 13:44:29
        
          2
          
          pub fn fmt_beijing<S>(dt: &DateTime<Utc>, s: S) -> Result<S::Ok, S::Error>
        
          3
          
          where
        
          4
          
              S: serde::Serializer,
        
          5
          
          {
        
          6
          
              let bj = to_beijing(*dt);
        
          7
          
              s.serialize_str(&bj.format("%Y-%m-%d %H:%M:%S").to_string())
        
          8
          
          }
        
      
    

这是核心的序列化函数,它:

  1. 接收 UTC 时间戳和序列化器
  2. 将 UTC 时间转换为北京时间
  3. 格式化为 "年-月-日 时:分:秒" 的字符串格式
  4. 通过序列化器返回字符串

关键技术点

1. Serde 自定义序列化

通过 #[serde(serialize_with = "fmt_beijing")] 属性,我们告诉 Serde 库在序列化 created_at 和 updated_at 字段时使用自定义的 fmt_beijing 函数,而不是默认的序列化方式。

2. OpenAPI 集成

#[schema(value_type = String, format = DateTime)] 属性确保了在生成 OpenAPI 文档时,这些字段会被正确描述为日期时间格式的字符串。

3. 时区处理

代码正确处理了时区转换,这对于国际化应用至关重要。数据库中通常存储 UTC 时间,但面向用户时需要显示本地时间。

实际应用场景

这种时间处理方式特别适用于:

  1. 中文用户界面的 API:确保时间显示符合中国用户的习惯
  2. 国际化应用:可以根据用户所在地动态调整时区显示
  3. 日志和审计:保持时间记录的一致性,同时提供友好的显示格式

总结

通过结合 SeaORM、Serde 和 Chrono 库,我们实现了一个优雅的日期时间处理方案,既保证了数据存储的一致性(使用 UTC),又提供了符合用户期望的显示格式(北京时间)。这种模式可以轻松扩展到其他需要自定义序列化的场景,是 Rust Web 开发中的一个实用技巧。

这种处理方式体现了 Rust 语言的强大之处:通过类型系统和 trait 实现,可以在编译期保证代码的正确性,同时保持高度的灵活性和可定制性。

MAVLink 消息处理指南

MAVLink消息处理系统摘要 本系统实现了一套完整的MAVLink消息处理机制,用于无人机通信与控制。核心功能包括: 消息接收:通过UDP连接持续接收飞控消息,支持心跳维持机制 消息处理:分类处理多种MAVLink消息类型,包括心跳、位置、姿态和航点相关消息 航点管理:实现航点下载状态机,支持分片请求和接收航点数据 消息转发:将处理后的消息通过MQTT发布到指定主题 系统采用多线程架构,包含独立的消息接收线程和主处理循环,通过通道进行线程间通信。关键特性包括航点下载状态机、错误处理和日志记录机制,确保通信

304 浏览

M3U8 下载助手油猴脚本 - 技术实现解析

M3U8下载助手技术解析 该油猴脚本通过注入拦截脚本实现对M3U8链接的全面捕获。核心架构包括: 请求拦截层:劫持XHR、fetch和WebSocket请求 DOM监听层:通过MutationObserver监控动态元素变化 跨域通信:iframe间使用postMessage传递数据 UI展示层:提供浮动按钮等交互界面 关键技术点: 使用document-start确保早期注入 通过保存原始方法实现API劫持 在send时而非open时检测URL 全面覆盖各种属性(src/href/data-src等) 脚

362 浏览

我做了一个局域网传文件的小工具,记录一下

本文记录了作者开发局域网文件传输工具的过程。起因是工作中遇到大文件传输不便的问题,作者选择用Rust语言开发,解决了WebSocket状态管理、大文件上传限制等技术难点。最终成品通过浏览器即可使用,支持文字聊天和文件传输,内存占用低。同事们试用后反馈良好,建议增加拖拽上传等功能。作者认为Rust虽开发较繁琐但运行高效稳定,并将项目开源供社区参与改进。

291 浏览

局域网聊天工具

这是一个基于Rust和Axum框架开发的局域网实时聊天工具,支持文本聊天、图片和文件分享功能。项目采用WebSocket实现实时通信,前端使用Tailwind CSS构建界面。主要功能包括实时消息传递、文件上传下载(限制100MB)、在线用户显示和消息历史记录。部署简单,只需Rust环境,通过Cargo编译运行即可启动服务。系统架构清晰,包含后端处理、前端界面和文件存储模块,适合局域网内团队协作使用。

350 浏览

这篇文章对你有帮助吗?