Rust 时间处理神器：chrono 从入门到实战

Rust 时间处理神器chrono 从入门到实战在 Rust 生态中chrono 凭借其遵循 ISO 8601 标准、支持时区、类型安全且性能优异的特性成为了 Rust 开发者的首选工具。本文将从入门到进阶并结合实际开发场景带你全面掌握 chrono 的使用方法以及避开时间处理中的那些“坑”让你在项目中轻松搞定时间操作。为什么选择 chronoRust 标准库中其实提供了基础的时间类型如std::time::SystemTime但是功能比较简陋不支持时区处理、复杂时间运算和格式化无法满足实际项目的需求。而 chrono 则完美弥补了这一短板。chrono 默认支持时区处理区分时区相关DateTimeTz和无时区Naive系列类型。同时遵循 ISO 8601 国际标准支持 RFC 2822、RFC 3339 等常见时间格式的解析与格式化。而且支持与 serde、chrono-tz 等库集成覆盖更多复杂场景如自定义时区、序列化。快速入门首先在Cargo.toml中添加 chrono 依赖[dependencies] chrono 0.4示例代码如下usechrono::{DateTime,Local,Utc};fnmain(){// 获取当前 UTC 时间推荐用于存储和跨系统交互letutc_now:DateTimeUtcUtc::now();println!(当前 UTC 时间{},utc_now);// 获取当前系统本地时间letlocal_now:DateTimeLocalLocal::now();println!(当前本地时间{},local_now);// 输出格式化时间自定义格式println!(本地时间格式化{},local_now.format(%Y年%m月%d日 %H时%M分%S秒));}运行代码会输出如下结果当前 UTC 时间2026-04-07 10:42:59.386671 UTC 当前本地时间2026-04-07 18:42:59.386908 08:00 本地时间格式化2026年04月07日 18时42分59秒chrono 类型解析无时区类型Naive 系列“Naive” 意为“朴素的”这类类型不包含时区信息仅表示“年-月-日-时-分-秒”的组合适用于不需要时区的场景比如本地日志等。NaiveDate仅表示日期年-月-日无时间和时区。NaiveTime仅表示时间时-分-秒-纳秒无日期和时区。NaiveDateTime表示日期时间无时区是NaiveDate和NaiveTime的组合。这里我们写一个创建和操作Naive系列类型的示例usechrono::{NaiveDate,NaiveDateTime,NaiveTime};fnmain(){// 创建 NaiveDate安全构造返回 Option避免 panicletdateNaiveDate::from_ymd_opt(2026,4,7).unwrap();println!(NaiveDate: {},date);// 创建 NaiveTimelettimeNaiveTime::from_hms_opt(9,30,0).unwrap();println!(NaiveTime: {},time);// 组合为 NaiveDateTimeletnaive_dtNaiveDateTime::new(date,time);println!(NaiveDateTime: {},naive_dt);// 无效日期返回 None避免运行时崩溃letinvalid_dateNaiveDate::from_ymd_opt(2026,13,32);println!(无效日期: {:?},invalid_date);// None}时区相关类型DateTimeTzDateTimeTz是 chrono 中最常用的类型其中Tz是时区泛型参数用于指定具体的时区。chrono 内置了三种常用时区实现Utc协调世界时零时区最推荐用于存储和跨系统通信避免时区混乱。Local系统本地时区运行时动态获取适用于本地时间展示。FixedOffset固定时区偏移如 UTC8、UTC-5适用于简单的时区场景。时区转换与操作的示例如下usechrono::{FixedOffset,Local,Utc};fnmain(){// 获取当前 UTC 时间letutc_nowUtc::now();println!(UTC 时间: {},utc_now);// 转换为本地时区letlocal_nowutc_now.with_timezone(Local);println!(本地时区时间: {},local_now);// 转换为固定时区UTC8如北京、上海时区letbeijing_tzFixedOffset::east_opt(8*3600).unwrap();// 8小时 * 3600秒/小时letbeijing_nowutc_now.with_timezone(beijing_tz);println!(北京时区时间: {},beijing_now);// 转换为纽约时区UTC-5letnew_york_tzFixedOffset::west_opt(5*3600).unwrap();letnew_york_nowutc_now.with_timezone(new_york_tz);println!(纽约时区时间: {},new_york_now);}需要注意的是不同时区的DateTime类型是不同的比如DateTimeUtc和DateTimeLocal不能直接比较需通过with_timezone方法转换到同一时区后再操作。时间间隔DurationDuration用于表示两个时间点之间的间隔支持秒、毫秒、微秒、纳秒等精度可与DateTime、NaiveDateTime进行加减运算。usechrono::{Duration,Utc};usestd::time::DurationasStdDuration;fnmain(){letnowUtc::now();// 创建 chrono 的 Duration1天 2小时 30分钟letdurationDuration::days(1)Duration::hours(2)Duration::minutes(30);// 时间加法当前时间 时间间隔letfuturenowduration;println!(1天2小时30分钟后: {},future);// 时间减法当前时间 - 时间间隔letpastnow-duration;println!(1天2小时30分钟前: {},past);// 计算两个时间点的间隔letdifffuture-past;println!(时间间隔: {}天 {}小时,diff.num_days(),diff.num_hours()%24);// 与标准库 Duration 转换letstd_durationStdDuration::from_secs(3600);letchrono_durationDuration::from_std(std_duration).unwrap();println!(标准库1小时转换为 chrono Duration: {:?},chrono_duration);}实战场景时间格式化与解析chrono 支持多种标准格式RFC 2822、RFC 3339和自定义格式格式化使用format方法解析使用parse_from_str、parse_from_rfc3339等方法。usechrono::{DateTime,NaiveDateTime,ParseError,Utc};fnmain()-Result(),ParseError{letnowUtc::now();// 标准格式输出println!(RFC 3339 格式: {},now.to_rfc3339());println!(RFC 2822 格式: {},now.to_rfc2822());// 自定义格式输出letcustom_formatnow.format(%Y-%m-%d %H:%M:%S.%3f).to_string();println!(自定义格式(保留3位毫秒): {},custom_format);// 解析字符串为 DateTimeletdt_str2026-04-07 09:30:00;letnaive_dtNaiveDateTime::parse_from_str(dt_str,%Y-%m-%d %H:%M:%S)?;println!(解析自定义格式: {},naive_dt);// 解析 RFC 3339 格式字符串带时区letrfc3339_str2026-04-07T09:30:0008:00;letdtDateTime::parse_from_rfc3339(rfc3339_str)?;println!(解析 RFC 3339 格式: {},dt);// 解析为 UTC 时间letutc_dt:DateTimeUtc2026-04-07T01:30:00Z.parse()?;println!(解析为 UTC 时间: {},utc_dt);Ok(())}时间戳与 DateTime 转换时间戳Unix Timestamp是指从 1970-01-01 00:00:00 UTC 到当前时间的秒数或毫秒数是跨系统时间传递的常用格式chrono 支持时间戳与DateTime、NaiveDateTime的双向转换。usechrono::{TimeZone,Utc};fnmain(){// DateTime 转换为时间戳秒letutc_nowUtc::now();lettimestamp_secutc_now.timestamp();// i64 类型秒级时间戳println!(当前 UTC 时间戳秒: {},timestamp_sec);// DateTime 转换为毫秒级时间戳lettimestamp_msutc_now.timestamp_millis();println!(当前 UTC 时间戳毫秒: {},timestamp_ms);// 时间戳秒转换为 DateTimeUtcletdt_from_secUtc.timestamp_opt(timestamp_sec,0).unwrap();println!(秒级时间戳转换回 DateTime: {},dt_from_sec);// 时间戳毫秒转换为 DateTimeUtcletdt_from_msUtc.timestamp_millis_opt(timestamp_ms).unwrap();println!(毫秒级时间戳转换回 DateTime: {},dt_from_ms);}复杂时间运算与判断在实际开发中有时候需要判断某个时间是否在指定区间、计算两个时间的差值、获取某个时间的前后时间点等chrono 提供了丰富的方法支持。usechrono::{Datelike,Duration,NaiveDate,Utc};fnmain(){letnowUtc::now();// 判断时间是否在指定区间内letstartnow-Duration::hours(1);letendnowDuration::hours(1);lettargetnow-Duration::minutes(30);letis_in_rangetargetstarttargetend;println!(目标时间是否在 [1小时前, 1小时后] 区间: {},is_in_range);// 获取指定时间的前后时间点安全方法避免溢出// 前一天letyesterdaynow.checked_sub_signed(Duration::days(1)).unwrap();// 后一周letnext_weeknow.checked_add_signed(Duration::weeks(1)).unwrap();println!(昨天此时: {},yesterday);println!(一周后此时: {},next_week);// 获取日期的详细信息年、月、日、星期等println!(当前年份: {},now.year());println!(当前月份: {},now.month());// 1-12println!(当前日期: {},now.day());println!(当前星期: {:?},now.weekday());// 枚举类型如 Mon、Tueprintln!(本月第几天: {},now.day0());// 0-30本月第一天为 0println!(今年第几天: {},now.ordinal());// 1-366闰年// 计算两个日期的天数差letdate1NaiveDate::from_ymd_opt(2026,4,7).unwrap();letdate2NaiveDate::from_ymd_opt(2026,12,31).unwrap();letdays_diff(date2-date1).num_days();println!(2026-04-07 到 2026-12-31 的天数差: {},days_diff);}避坑指南忽视时区直接使用 Local 存储时间在开发过程中将DateTimeLocal存储到数据库或用于跨系统交互的场景下这样是会有问题的当涉及到跨时区的时候就会导致时间错乱如果遇到夏令时切换的话则造成时间重复或跳跃的问题。正确的做法应该是存储时使用DateTimeUtc展示时再转换为本地时区。直接比较不同时区的 DateTime不同时区的DateTime是不能参与比较的比如Utc::now() Local::now()这直接就会报错。正确的做法应该是先将所有时间转换到同一时区如 UTC再进行比较。总结chrono 作为 Rust 时间处理的“瑞士军刀”覆盖了从基础时间操作到复杂跨时区场景的几乎所有需求其类型安全、标准兼容、性能优异的特性使其成为 Rust 项目的首选时间库。