timeago

在Rust中，将Duration格式化为类似"1小时前"或"01hou"的字符串。

目前它不考虑日历，并假设每个月大约有30.4天。

将此字符串解析回Duration超出了此crate的范围。也许可以看看chrono-english crate。

当isolang功能关闭时，它支持从版本1.24开始的Rust。

API

简化API摘录（伪代码）：

pub struct Formatter<L : Language = English>{...}

impl Formatter {
    pub fn new() -> Formatter<English>;
    pub fn with_language(l: Language) -> Self;
    pub fn num_items(&mut self, x: usize) -> &mut Self;
    pub fn max_unit(&mut self, x: TimeUnit) -> &mut Self;
    pub fn min_unit(&mut self, x: TimeUnit) -> &mut Self;
    pub fn too_low(&mut self, x: &'static str) -> &mut Self;
    pub fn too_high(&mut self, x: &'static str) -> &mut Self;
    pub fn max_duration(&mut self, x: Duration) -> &mut Self;
    pub fn ago(&mut self, x: &'static str) -> &mut Self;
    
    pub fn convert(&self, d: Duration) -> String;
    pub fn convert_chrono(&self, from: chrono::DateTime, to: chrono::DateTime) -> String;
}

pub fn from_isolang(x : isolang::Language) -> Option<Box<Language>>;

pub fn format_5chars(d: Duration) -> String;

可以从isolang::Language构造Language。

翻译

• 英语
• 俄语
• 法语
• 葡萄牙语（贡献）
• 德语（未检查）
• 白俄罗斯语（未检查）
• 波兰语（未检查）
• 西班牙语（贡献）
• 中文（贡献）
• 罗马尼亚语（贡献）
• 瑞典语（贡献）
• 土耳其语（贡献）
• 日语（贡献）
• 丹麦语（贡献）
• 意大利语（贡献）
• 乌克兰语（贡献）
• 泰语（贡献）

如果您检查了某种语言并确认它正确，请提交一个拉取请求，删除上面列表中的"（未检查）“或”（贡献）"。

工具

有一个辅助命令行工具，可以在添加新翻译时更容易地进行实验：

$ cargo run --features isolang en
    Finished dev [unoptimized + debuginfo] target(s) in 0.0 secs
     Running `target/debug/timeago en`
60
1 minute ago
7200
2 hours ago

另请参阅

• chrono-humanize
• compound_duration - 将Duration拆分为周/天/分钟/等部分

完整示例代码：

use std::time::Duration;
use timeago::{Formatter, English};

fn main() {
    // 创建默认的英语格式化器
    let mut formatter = Formatter::new();
    
    // 设置显示的时间单位数量
    formatter.num_items(2);
    
    // 创建一些时间间隔
    let durations = vec![
        Duration::from_secs(60),        // 1分钟
        Duration::from_secs(3600),      // 1小时
        Duration::from_secs(86400),     // 1天
        Duration::from_secs(2592000),   // 约30天
    ];
    
    // 格式化并显示时间间隔
    for duration in durations {
        let formatted = formatter.convert(duration);
        println!("{} seconds -> {}", duration.as_secs(), formatted);
    }
    
    // 使用5字符格式函数
    let short_format = timeago::format_5chars(Duration::from_secs(3660));
    println!("5字符格式: {}", short_format);
}

以下是一个完整的示例demo：

use std::time::Duration;
use timeago::{Formatter, English};
use chrono::{Utc, TimeZone};

fn main() {
    // 示例1：使用默认格式化器
    println!("=== 示例1：基本使用 ===");
    let mut formatter = Formatter::new();
    
    let test_durations = vec![
        Duration::from_secs(30),        // 30秒
        Duration::from_secs(120),       // 2分钟
        Duration::from_secs(7200),      // 2小时
        Duration::from_secs(172800),    // 2天
        Duration::from_secs(5184000),   // 约60天
    ];
    
    for duration in test_durations {
        let formatted = formatter.convert(duration);
        println!("{}秒 -> {}", duration.as_secs(), formatted);
    }
    
    // 示例2：使用中文格式化
    println!("\n=== 示例2：中文格式化 ===");
    if let Some(chinese_lang) = timeago::from_isolang(isolang::Language::Cmn) {
        let mut chinese_formatter = Formatter::with_language(*chinese_lang);
        chinese_formatter.num_items(1);
        
        let durations = vec![
            Duration::from_secs(60),
            Duration::from_secs(3600),
            Duration::from_secs(86400),
        ];
        
        for duration in durations {
            let formatted = chinese_formatter.convert(duration);
            println!("{}秒 -> {}", duration.as_secs(), formatted);
        }
    }
    
    // 示例3：使用chrono时间点
    println!("\n=== 示例3：使用chrono时间点 ===");
    let now = Utc::now();
    let past_time = Utc.with_ymd_and_hms(2023, 1, 1, 12, 0, 0).unwrap();
    
    let time_diff = formatter.convert_chrono(past_time, now);
    println!("时间差: {}", time_diff);
    
    // 示例4：5字符短格式
    println!("\n=== 示例4：5字符短格式 ===");
    let short_durations = vec![
        Duration::from_secs(59),        // 59秒
        Duration::from_secs(60),        // 1分钟
        Duration::from_secs(3600),      // 1小时
        Duration::from_secs(86400),     // 1天
    ];
    
    for duration in short_durations {
        let short_format = timeago::format_5chars(duration);
        println!("{}秒 -> {}", duration.as_secs(), short_format);
    }
    
    // 示例5：自定义配置
    println!("\n=== 示例5：自定义配置 ===");
    let mut custom_formatter = Formatter::new();
    custom_formatter
        .num_items(3)                   // 显示最多3个时间单位
        .max_unit(timeago::TimeUnit::Days) // 最大显示到天
        .min_unit(timeago::TimeUnit::Minutes) // 最小显示到分钟
        .too_low("刚刚")                 // 设置时间太短的显示文本
        .too_high("很久以前")            // 设置时间太长的显示文本
        .ago("之前");                    // 设置时间后缀
    
    let custom_durations = vec![
        Duration::from_secs(30),        // 时间太短
        Duration::from_secs(3661),      // 1小时1分钟1秒
        Duration::from_secs(90000),     // 1天1小时（超过最大单位）
    ];
    
    for duration in custom_durations {
        let formatted = custom_formatter.convert(duration);
        println!("{}秒 -> {}", duration.as_secs(), formatted);
    }
}