掌握時間：Chrono Rust日期時間庫詳解

在軟體開發中，處理時間和日期是一個不可或缺的任務。Rust 社群有一個優秀的日期時間庫叫做 Chrono，它提供了豐富的API來處理時間。這篇文章將深入探討 Chrono 的功能，並透過豐富的範例來演示如何在 Rust 應用程式中使用它。

Chrono 簡介

Chrono 是 Rust 程式語言的一個日期和時間處理庫。它被設計來處理高精度和多文化支持的日期時間。Chrono 支持處理時區，也支持無時區的時間處理，讓開發人員能靈活處理日期和時間。

安裝 Chrono

要在 Rust 計畫中使用 Chrono，你需要在你的 Cargo.toml 檔中添加如下依賴項：

[dependencies]
chrono = "0.4"


這會將最新版本的 Chrono 庫添加到你的計畫中。

基本日期和時間型別

Chrono 提供了幾個基本型別來表示時間：

建立和操作日期時間

建立當前日期時間

要獲取當前時間，可以使用 Utc::now() 或者 Local::now() ：

use chrono::{DateTime, Local, Utc};
fnmain() {
let now_utc: DateTime<Utc> = Utc::now();
let now_local: DateTime<Local> = Local::now();
println!("當前 UTC 時間: {}", now_utc);
println!("當前本地時間: {}", now_local);
}


解析日期時間字串

Chrono 提供了 parse_from_str 函式來從字串中解析時間：

use chrono::{DateTime, Utc, NaiveDateTime, format::ParseError};
fnparse_date_time_from_str(date_str: &str, fmt: &str) -> Result<DateTime<Utc>, ParseError> {
let naive_date_time = NaiveDateTime::parse_from_str(date_str, fmt)?;
Ok(DateTime::from_utc(naive_date_time, Utc))
}
fnmain() {
let date_time_result = parse_date_time_from_str("2020-09-05 23:10:20", "%Y-%m-%d %H:%M:%S");
match date_time_result {
Ok(date_time) => println!("解析出的時間為：{}", date_time),
Err(e) => eprintln!("解析錯誤：{}", e),
}
}



時間計算和比較

Chrono 允許你對日期和時間進行前後計算。你可以使用 checked_add_signed 和 checked_sub_signed 方法來計算時間的加減。

use chrono::{DateTime, Duration, Utc};
fnmain() {
let now = Utc::now();
let after_ten_days = now.checked_add_signed(Duration::days(10)).unwrap();
let before_ten_days = now.checked_sub_signed(Duration::days(10)).unwrap();
println!("十天後的時間：{}", after_ten_days);
println!("十天前的時間：{}", before_ten_days);
}



同時，Chrono 支持使用 > 、 < 和 == 操作符來比較時間：

use chrono::{DateTime, Utc};
fnmain() {
let now = Utc::now();
let earlier = now - chrono::Duration::seconds(5);
println!("現在是：{}", now);
println!("五秒前是：{}", earlier);
assert!(now > earlier, "現在的時間應該比五秒前晚");
}



格式化與顯示

Chrono 提供了格式化時間日期的功能。你可以利用 format 方法輸出不同格式的日期時間字串：

use chrono::Utc;
fnmain() {
let now = Utc::now();
println!("現在的時間是：{}", now.format("%Y年%m月%d日 %H:%M:%S"));
}


時區處理

Chrono 支持時區轉換。你可以使用 with_timezone 方法將 UTC 時間轉換為任何指定的時區時間：

use chrono::{DateTime, Utc, TimeZone};
fnmain() {
let utc_now: DateTime<Utc> = Utc::now();
let shanghai = chrono::FixedOffset::east(8 * 3600);
let shanghai_now = utc_now.with_timezone(&shanghai);
println!("上海時間：{}", shanghai_now);
}



總結

Chrono 是一個非常強大的 Rust 日期時間處理庫，它提供了多種日期時間的操作和格式化的方法。這篇文章僅僅是對 Chrono 的淺嘗輒止，實際上 Chrono 還有很多高級功能等待你去探索，比如客製格式化輸出、解析RFC3339和ISO8601格式的字串等等。

Chrono 庫經過時間的考驗，成為 Rust 社群中日期時間處理的首選。透過引入和利用 Chrono，你可以在你的 Rust 應用程式中輕松地處理所有與日期和時間相關的任務。

文章精選

點 擊 關 註 並 掃 碼 添 加 進 交 流 群

領 取 「Rust 語 言 」 學 習 資 料

關註公眾號並回復 「Chrono」 立即獲取計畫地址。