Rust日期时间处理库datetime的使用指南

datetime是Rust中一个强大的日期时间处理库，提供了高效解析、格式化和计算日期时间操作的功能。下面介绍其主要使用方法：

基本使用

首先在Cargo.toml中添加依赖：

[dependencies]
datetime = "0.5.0"

创建日期时间对象

use datetime::{LocalDateTime, Month, TimeZone};

// 创建当前本地时间
let now = LocalDateTime::now();

// 创建指定日期时间
let specific_date = LocalDateTime::at(2023, Month::November, 15, 10, 30, 0).unwrap();

日期时间解析

use datetime::{LocalDateTime, TimeZone};

// 从字符串解析
let dt = LocalDateTime::parse("2023-11-15 10:30:00", "%Y-%m-%d %H:%M:%S").unwrap();
println!("解析后的时间: {}", dt);

日期时间格式化

use datetime::{LocalDateTime, TimeZone};

let now = LocalDateTime::now();

// 格式化为字符串
let formatted = now.format("%Y-%m-%d %H:%M:%S");
println!("当前时间: {}", formatted);

// 自定义格式
let custom_format = now.format("%A, %B %d, %Y at %I:%M %p");
println!("自定义格式: {}", custom_format);

日期时间计算

use datetime::{LocalDateTime, Duration, TimeZone};

let mut dt = LocalDateTime::now();

// 增加时间
dt += Duration::days(5);  // 增加5天
dt += Duration::hours(2); // 增加2小时

// 减少时间
dt -= Duration::weeks(1); // 减少1周

println!("计算后的时间: {}", dt);

日期时间比较

use datetime::{LocalDateTime, TimeZone};

let dt1 = LocalDateTime::now();
let dt2 = dt1 + Duration::hours(1);

if dt1 < dt2 {
    println!("dt1 早于 dt2");
} else if dt1 > dt2 {
    println!("dt1 晚于 dt2");
} else {
    println!("时间相同");
}

获取日期时间组件

use datetime::{LocalDateTime, TimeZone};

let dt = LocalDateTime::now();

println!("年: {}", dt.year());
println!("月: {}", dt.month()); // 返回Month枚举
println!("日: {}", dt.day());
println!("时: {}", dt.hour());
println!("分: {}", dt.minute());
println!("秒: {}", dt.second());

时区处理

use datetime::{LocalDateTime, TimeZone, UTCOffset};

// 创建带时区的日期时间
let offset = UTCOffset::hours(8); // UTC+8
let dt = LocalDateTime::now().with_timezone(offset);

println!("带时区的时间: {}", dt);

工作日计算示例

use datetime::{LocalDateTime, Duration, Weekday, TimeZone};

let mut dt = LocalDateTime::now();

// 计算下一个工作日
while dt.weekday() == Weekday::Saturday || dt.weekday() == Weekday::Sunday {
    dt += Duration::days(1);
}

println!("下一个工作日是: {}", dt.format("%Y-%m-%d"));

完整示例代码

use datetime::{LocalDateTime, Month, TimeZone, Duration, Weekday, UTCOffset};

fn main() {
    // 1. 创建日期时间对象
    let now = LocalDateTime::now();
    println!("当前时间: {}", now);
    
    let specific_date = LocalDateTime::at(2023, Month::November, 15, 10, 30, 0).unwrap();
    println!("指定日期: {}", specific_date);

    // 2. 日期时间解析
    let parsed = LocalDateTime::parse("2023-11-15 10:30:00", "%Y-%m-%d %H:%M:%S").unwrap();
    println!("解析结果: {}", parsed);

    // 3. 日期时间格式化
    let formatted = now.format("%Y-%m-%d %H:%M:%S");
    println!("格式化: {}", formatted);
    
    let custom_fmt = now.format("%A, %B %d, %Y at %I:%M %p");
    println!("自定义格式: {}", custom_fmt);

    // 4. 日期时间计算
    let mut dt = now.clone();
    dt += Duration::days(5);
    dt += Duration::hours(2);
    dt -= Duration::weeks(1);
    println!("计算后时间: {}", dt);

    // 5. 日期时间比较
    let dt1 = now;
    let dt2 = dt1 + Duration::hours(1);
    if dt1 < dt2 {
        println!("{} 早于 {}", dt1, dt2);
    }

    // 6. 获取日期组件
    println!("年: {}", dt2.year());
    println!("月: {}", dt2.month());
    println!("日: {}", dt2.day());

    // 7. 时区处理
    let offset = UTCOffset::hours(8);
    let dt_with_tz = dt2.with_timezone(offset);
    println!("带时区时间: {}", dt_with_tz);

    // 8. 工作日计算
    let mut workday = dt2;
    while workday.weekday() == Weekday::Saturday || workday.weekday() == Weekday::Sunday {
        workday += Duration::days(1);
    }
    println!("下一个工作日: {}", workday.format("%Y-%m-%d"));
}

datetime库提供了丰富的日期时间操作功能，性能高效且API设计合理，是Rust中进行日期时间处理的优秀选择。