Struct DateUtil 

pub struct DateUtil;

日期工具，包含常用快捷生成，如获取当日时间字符串、格式化、时间字符串解析等

Implementations

impl DateUtil

pub fn current_date() -> NaiveDate

pub fn current_date_string() -> String

获取当前日期字符串，输出格式：%Y-%m-%d

pub fn current_datetime() -> NaiveDateTime

pub fn current_datetime_string() -> String

pub fn today_string() -> String

获取当前日期的字符串表示

该函数获取本地当前时间，并将其格式化为“年-月-日“的字符串格式。

返回值

返回格式为“YYYY-MM-DD“的日期字符串

pub fn today_date() -> NaiveDate

pub fn parse_day_string(day_string: &str) -> Result<NaiveDate, ParseError>

pub fn day_offset(offset: i64) -> String

进行日期偏移，offset为偏移量，正数表示向后偏移，负数表示向前偏移

返回值

返回格式为“YYYY-MM-DD“的日期字符串

pub fn yesterday_string() -> String

获取昨天日期的字符串表示

该函数计算昨天的日期，并将其格式化为“YYYY-MM-DD“格式的字符串。

Returns

返回昨天日期的字符串表示，格式为“YYYY-MM-DD“

Example

let yesterday = yesterday_string();
println!("{}", yesterday); // 输出类似 "2023-12-06"

pub fn yesterday_date() -> NaiveDate

pub fn tomorrow_string() -> String

获取明天日期的字符串表示

该函数计算明天的日期，并将其格式化为“YYYY-MM-DD“格式的字符串。

返回值

返回表示明天日期的字符串，格式为“YYYY-MM-DD“

pub fn tomorrow_date() -> NaiveDate

pub fn cmp_string( time1: &str, time2: &str, fmt: &str, ) -> Result<Ordering, ParseError>

比较两个时间字符串的大小

该函数将两个时间字符串按照指定的格式解析为DateTime对象，然后进行比较。

参数

• time1 - 第一个时间字符串
• time2 - 第二个时间字符串
• fmt - 时间格式字符串，用于解析time1和time2

返回值

• Ok(Ordering) - 比较结果，Ordering::Less表示time1小于time2， Ordering::Equal表示time1等于time2， Ordering::Greater表示time1大于time2
• Err(ParseError) - 时间解析失败时返回错误信息

错误处理

如果任一时间字符串无法按照指定格式解析，函数将返回ParseError错误

pub fn current_time_string() -> String

获取当前时间字符串，输出格式：%Y-%m-%d %H:%M:%S

pub fn parse_datetime(time: &str) -> Result<NaiveDateTime, ParseError>

参数

• time: 格式如：“2025-08-30 12:00:00”

pub fn parse_string(time: &str, fmt: &str) -> Result<NaiveDateTime, ParseError>

pub fn current_timestamp() -> u64

当前时间戳（秒），返回10位长度

pub fn timestamp(time: DateTime<Local>) -> u64

返回10位时间戳（秒）

pub fn timestamp_add(time: DateTime<Local>, seconds: i64) -> u64

时间戳加减法（秒）