Rust 中的日期时间序列化:将 UTC 转换为北京时间
Rust 中的日期时间序列化:将 UTC 转换为北京时间
在 Rust 后端开发中,处理日期时间并确保其在 API 响应中以正确的时区显示是一个常见需求。本文将基于提供的代码示例,探讨如何在 SeaORM 模型中使用自定义序列化函数,将 UTC 时间转换为北京时间并格式化输出。
代码结构分析
首先,让我们看一下主要的 Model 结构体:
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)、描述以及创建和更新时间字段。
核心功能:时区转换与格式化
时区转换函数
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 方法进行转换。
自定义序列化函数
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
}
这是核心的序列化函数,它:
- 接收 UTC 时间戳和序列化器
- 将 UTC 时间转换为北京时间
- 格式化为 "年-月-日 时:分:秒" 的字符串格式
- 通过序列化器返回字符串
关键技术点
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 时间,但面向用户时需要显示本地时间。
实际应用场景
这种时间处理方式特别适用于:
- 中文用户界面的 API:确保时间显示符合中国用户的习惯
- 国际化应用:可以根据用户所在地动态调整时区显示
- 日志和审计:保持时间记录的一致性,同时提供友好的显示格式
总结
通过结合 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 浏览