日期库chrono
Rust的时间操作主要用到chrono库，接下来我将简单选一些常用的操作进行介绍，如果想了解更多细节，请查看官方文档。
use chrono::{Datelike, Duration, Local, TimeZone, Timelike}; fn main() { let fmt = "%Y年%m月%d日 %H:%M:%S"; let now = Local::now().format(fmt); println!("{}", now); let mut parse = Local .datetime_from_str("2022年3月19日 13:30:59", fmt) .unwrap(); println!("{:?}", parse); println!( "{}-{}-{} {}:{}:{}", parse.year(), parse.month(), parse.day(), parse.hour(), parse.minute(), parse.second() ); println!("{}", parse.date()); parse = Local.ymd(2012, 12, 12).and_hms(12, 12, 12); println!("{}", parse); parse = parse + Duration::days(2); println!("{}", parse); parse = parse + Duration::hours(2); println!("{}", parse); parse = parse + Duration::minutes(2); println!("{}", parse); parse = parse + Duration::seconds(2); println!("{}", parse); }
日期及时间
测量运行时间
计算从 time::Instant::now 开始运行的时间 time::Instant::elapsed。
调用 time::Instant::elapsed 将返回 time::Duration，我们将在实例末尾打印该时间。此方法不会更改或者重置 time::Instant 对象。
use std::time::Instant; use std::{thread, time}; fn main(){ let start = Instant::now(); // 设置休眠时间，1s， let ten_millis = time::Duration::from_millis(1); thread::sleep(ten_millis); let duration = start.elapsed(); //计算获得的时间会超过1s，因为系统运行也会消耗一定时间 println!("显示两行代码之间消耗的时间() is: {:?}", duration); }
结果
显示两行代码之间消耗的时间() is: 8.1735ms
chrono
在rust中，使用日期库需要引入第三方库，chrono 是在rsut中使用最多的库，所以我们接下来的的日期处理都基于此库。所以需要我们在Cargo.toml引入chrono = "0.4.31"
时间计算
chrono 中提供的时间计算的方法有很多，接下来我将介绍几种常用的方法。
use chrono::{DateTime, Duration, Utc, Days, Months}; fn main() { // 获取 世界统一时间的现在时间 let now = Utc::now(); // 获取当地时间的现在时间 // let local=Local::now(); println!("当前时间: {}", now); // checked_add_signed 添加指定的时间到 let almost_three_weeks_from_now = now.checked_add_signed(Duration::weeks(2)); // checked_add_days 添加指定的天数 let after_one_day=now.checked_add_days(Days::new(1)); // checked_sub_months 添加指定的月数 let after_one_mouth=now.checked_sub_months(Months::new(1)); match almost_three_weeks_from_now { Some(x) => println!("两周后的时间: {}", x), None => eprintln!("时间格式不对"), } match after_one_day { Some(x) => println!("一天后的时间: {}", x), None => eprintln!("时间格式不对"), } match after_one_mouth { Some(x) => println!("一月后的时间: {}", x), None => eprintln!("时间格式不对"), } }
在计算时间差比较麻烦，需要先指定格式，以下是计算时间差的代码
let start_of_period = Utc.ymd(2020, 1, 1).and_hms(0, 0, 0); let end_of_period = Utc.ymd(2021, 1, 1).and_hms(0, 0, 0); let duration = end_of_period - start_of_period; println!("num days = {}", duration.num_days());
时间的时区转换
使用 offset::Local::now 获取本地时间并显示，然后使用 DateTime::from_utc 结构体方法将其转换为 UTC 标准格式。最后，使用 offset::FixedOffset 结构体，可以将 UTC 时间转换为 UTC+8 和 UTC-2。
use chrono::{DateTime, FixedOffset, Local, Utc}; fn main() { let local_time = Local::now(); // 设置时间格式 let utc_time = DateTime::<Utc>::from_utc(local_time.naive_utc(), Utc); // 进行时间偏移 let china_timezone = FixedOffset::east(8 * 3600); println!("现在时间 {}", local_time); println!("UTC 时间 {}", utc_time); println!( "香港时间 {}", utc_time.with_timezone(&china_timezone) ); }
检查日期和时间
chrono-badge cat-date-and-time-badge
通过 Timelike 获取当前 UTC DateTime 及其时/分/秒，通过 Datelike 获取其年/月/日/工作日。
use chrono::{Datelike, Timelike, Utc}; fn main() { let now = Utc::now(); let (is_pm, hour) = now.hour12(); //把时间转化为12小时制 println!( "The current UTC time is {:02}:{:02}:{:02} {}", //设置格式 hour, now.minute(), now.second(), if is_pm { "PM" } else { "AM" } ); println!( "And there have been {} seconds since midnight", now.num_seconds_from_midnight() //输出到午夜的时间 ); let (is_common_era, year) = now.year_ce();//把时间转化为一年为单位 println!( "The current UTC date is {}-{:02}-{:02} {:?} ({})", year, now.month(), now.day(), now.weekday(), if is_common_era { "CE" } else { "BCE" } //判断时间是公元前，还是公元后 ); println!( "And the Common Era began {} days ago", //据公元开始有多少年 now.num_days_from_ce() ); }
日期和时间的格式化显示
使用 Utc::now 获取并显示当前 UTC 时间。使用 DateTime::to_rfc2822 将当前时间格式化为熟悉的 RFC 2822 格式，使用 DateTime::to_rfc3339 将当前时间格式化为熟悉的 RFC 3339 格式，也可以使用 DateTime::format 自定义时间格式。
use chrono::{DateTime, Utc}; fn main() { let now: DateTime<Utc> = Utc::now(); println!("UTC now is: {}", now); println!("UTC now in RFC 2822 is: {}", now.to_rfc2822()); println!("UTC now in RFC 3339 is: {}", now.to_rfc3339()); println!("UTC now in a custom format is: {}", now.format("%a %b %e %T %Y")); }
效果
UTC now is: 2023-12-02 13:22:23.639812500 UTC UTC now in RFC 2822 is: Sat, 2 Dec 2023 13:22:23 +0000 UTC now in RFC 3339 is: 2023-12-02T13:22:23.639812500+00:00 UTC now in a custom format is: Sat Dec 2 13:22:23 2023
将字符串解析为 DateTime 结构体
熟悉的时间格式 RFC 2822、RFC 3339，以及自定义时间格式，通常用字符串表达。要将这些字符串解析为 DateTime 结构体，可以分别用 DateTime::parse_from_rfc2822、DateTime::parse_from_rfc3339，以及 DateTime::parse_from_str。
可以在 chrono::format::strftime 中找到适用于 DateTime::parse_from_str 的转义序列。注意：DateTime::parse_from_str 要求这些 DateTime 结构体必须是可创建的，以便它唯一地标识日期和时间。要解析不带时区的日期和时间，请使用 NaiveDate、NaiveTime，以及 NaiveDateTime。
use chrono::{DateTime, NaiveDate, NaiveDateTime, NaiveTime}; use chrono::format::ParseError; fn main() -> Result<(), ParseError> { let rfc2822 = DateTime::parse_from_rfc2822("Tue, 1 Jul 2003 10:52:37 +0200")?; println!("{}", rfc2822); let rfc3339 = DateTime::parse_from_rfc3339("1996-12-19T16:39:57-08:00")?; println!("{}", rfc3339); let custom = DateTime::parse_from_str("5.8.1994 8:00 am +0000", "%d.%m.%Y %H:%M %P %z")?; println!("{}", custom); let time_only = NaiveTime::parse_from_str("23:56:04", "%H:%M:%S")?; println!("{}", time_only); let date_only = NaiveDate::parse_from_str("2015-09-05", "%Y-%m-%d")?; println!("{}", date_only); let no_timezone = NaiveDateTime::parse_from_str("2015-09-05 23:56:04", "%Y-%m-%d %H:%M:%S")?; println!("{}", no_timezone); Ok(()) }
效果
2003-07-01 10:52:37 +02:00 1996-12-19 16:39:57 -08:00 1994-08-05 08:00:00 +00:00 23:56:04 2015-09-05 2015-09-05 23:56:04
日期和 UNIX 时间戳的互相转换
使用 NaiveDateTime::timestamp 将由 NaiveDate::from_ymd 生成的日期和由 NaiveTime::from_hms 生成的时间转换为 UNIX 时间戳。然后，它使用 NaiveDateTime::from_timestamp 计算自 UTC 时间 1970 年 01 月 01 日 00:00:00 开始的 10 亿秒后的日期。
use chrono::{NaiveDate, NaiveDateTime}; fn main() { let date_time: NaiveDateTime = NaiveDate::from_ymd(2017, 11, 12).and_hms(17, 33, 44); println!( "Number of seconds between 1970-01-01 00:00:00 and {} is {}.", date_time, date_time.timestamp()); let date_time_after_a_billion_seconds = NaiveDateTime::from_timestamp(1_000_000_000, 0); println!( "Date after a billion seconds since 1970-01-01 00:00:00 was {}.", date_time_after_a_billion_seconds); }
