wordval-utils 1.0.0

Wordval utilities: string manipulation, date handling, masking, ID generation, validation, crypto, web helpers
Documentation
//! 日期工具:格式化、相对时间、时间戳互转

use chrono::{DateTime, Local, TimeZone, Utc};

/// 日期工具 —— 格式化、相对时间描述、时间戳互转、日界计算
///
/// `now()` 返回 UTC,`now_local()` 返回本地时区,`Date` 为零大小结构体(无状态)。
pub struct Date;

impl Date {
    /// 获取当前 UTC 时间
    pub fn now() -> DateTime<Utc> {
        Utc::now()
    }

    /// 获取当前本地时间
    pub fn now_local() -> DateTime<Local> {
        Local::now()
    }

    /// 日期格式化(支持任意时区:UTC / Local / 固定偏移)
    pub fn fmt<Tz: TimeZone>(dt: &DateTime<Tz>, fmt: &str) -> String
    where
        Tz::Offset: std::fmt::Display,
    {
        dt.format(fmt).to_string()
    }

    /// 从时间戳创建 DateTime
    pub fn from_timestamp(ts: i64) -> DateTime<Utc> {
        DateTime::from_timestamp(ts, 0).unwrap_or_default()
    }

    /// 相对时间描述(如:3分钟前、2小时前)
    pub fn relative(ts: i64) -> String {
        let then = DateTime::from_timestamp(ts, 0).unwrap_or_default();
        let diff = Utc::now() - then;

        if diff.num_seconds() < 60 {
            format!("{}秒前", diff.num_seconds())
        } else if diff.num_minutes() < 60 {
            format!("{}分钟前", diff.num_minutes())
        } else if diff.num_hours() < 24 {
            format!("{}小时前", diff.num_hours())
        } else if diff.num_days() < 30 {
            format!("{}天前", diff.num_days())
        } else if diff.num_days() < 365 {
            format!("{}个月前", diff.num_days() / 30)
        } else {
            format!("{}年前", diff.num_days() / 365)
        }
    }

    /// 获取当天的起始时刻(00:00:00 UTC)
    pub fn begin_of_day(dt: &DateTime<Utc>) -> DateTime<Utc> {
        dt.date_naive().and_hms_opt(0, 0, 0).unwrap().and_utc()
    }

    /// 获取当天的结束时刻(23:59:59 UTC)
    pub fn end_of_day(dt: &DateTime<Utc>) -> DateTime<Utc> {
        dt.date_naive().and_hms_opt(23, 59, 59).unwrap().and_utc()
    }
}