Struct CronUtil 

pub struct CronUtil;

Implementations

impl CronUtil

pub fn parse(expression: &str) -> Result<CronExpression, CronError>

解析 cron 表达式为结构体 Parse cron expression into a struct

参数

Parameters

• expression - cron 表达式，如 “0 0 * * *”
• expression - cron expression, e.g. “0 0 * * *”

示例

Example

let cron = CronUtil::parse("0 0 * * *").unwrap();

pub fn validate(expression: &str) -> bool

验证 cron 表达式是否有效 Validate if a cron expression is valid

参数

Parameters

• expression - cron 表达式，如 “0 0 * * *”
• expression - cron expression, e.g. “0 0 * * *”

示例

Example

if CronUtil::validate("0 0 * * *") {
    println!("Valid cron expression");
}

pub fn next_execution(expression: &str) -> Result<DateTime<Local>, CronError>

从当前时间计算下一次执行时间 Calculate next execution time from current time

参数

Parameters

• expression - cron 表达式
• expression - cron expression

示例

Example

let next = CronUtil::next_execution("0 0 * * *").unwrap();
println!("Next execution time: {}", next);

pub fn next_execution_from( expression: &str, from: DateTime<Local>, ) -> Result<DateTime<Local>, CronError>

从指定时间计算下一次执行时间 Calculate next execution time from a specific time

参数

Parameters

• expression - cron 表达式
• expression - cron expression
• from - 起始时间
• from - start time

pub fn describe(expression: &str) -> Result<String, CronError>

生成 cron 表达式的人类可读描述 Generate human-readable description of a cron expression

参数

Parameters

• expression - cron 表达式
• expression - cron expression

示例

Example

let desc = CronUtil::describe("0 0 * * *").unwrap();
println!("{}", desc); // "Every day at 00:00"

pub fn count_executions_between( expression: &str, start: DateTime<Local>, end: DateTime<Local>, ) -> Result<u32, CronError>

计算两个日期之间有多少次 cron 触发 Count number of cron executions between two dates

参数

Parameters

• expression - cron 表达式
• expression - cron expression
• start - 开始时间
• start - start time
• end - 结束时间
• end - end time

pub fn next_n_executions( expression: &str, count: usize, ) -> Result<Vec<DateTime<Local>>, CronError>

获取未来 n 次执行时间 Get next n execution times

参数

Parameters

• expression - cron 表达式
• expression - cron expression
• count - 需要获取的次数
• count - number of times to get

pub fn matches( expression: &str, date_time: DateTime<Local>, ) -> Result<bool, CronError>

根据 cron 表达式判断某个时间点是否会触发 Check if a specific time matches a cron expression

参数

Parameters

• expression - cron 表达式
• expression - cron expression
• date_time - 待检查的时间点
• date_time - time to check

pub fn parse_alias(alias: &str) -> Result<String, CronError>

解析常用的 cron 表达式别名 Parse common cron expression aliases

参数

Parameters

• alias - cron 表达式别名，如 “@daily”, “@hourly”
• alias - cron expression alias, e.g. “@daily”, “@hourly”

pub fn generate_cron( month: i32, week_day: i32, day: i32, hour: i32, minute: i32, ) -> String

根据给定的月、周、日、时、分生成 cron 表达式 Generate cron expression from given month, week day, day, hour and minute

参数

Parameters

• month - 月份，1-12，0 表示所有月份
• month - Month, 1-12, 0 means all months
• week_day - 星期几，0-7（0 和 7 都表示星期日），-1 表示所有星期
• week_day - Day of week, 0-7 (0 and 7 both represent Sunday), -1 means all days
• day - 日期，1-31，0 表示所有日期
• day - Day of month, 1-31, 0 means all days
• hour - 小时，0-23，-1 表示所有小时
• hour - Hour, 0-23, -1 means all hours
• minute - 分钟，0-59，-1 表示所有分钟
• minute - Minute, 0-59, -1 means all minutes

返回

Returns

• String - 生成的 cron 表达式
• String - Generated cron expression