27个稳定版本

2.0.19 2024年2月7日
2.0.18 2023年6月26日
2.0.17 2023年5月2日
2.0.2 2023年3月28日
1.3.9 2022年11月27日

#1107魔法豆

Download history 18/week @ 2024-04-07 22/week @ 2024-04-14 48/week @ 2024-04-21 25/week @ 2024-04-28 29/week @ 2024-05-05 34/week @ 2024-05-12 31/week @ 2024-05-19 15/week @ 2024-05-26 42/week @ 2024-06-02 15/week @ 2024-06-09 23/week @ 2024-06-16 30/week @ 2024-06-23 28/week @ 2024-06-30 11/week @ 2024-07-07 25/week @ 2024-07-14 12/week @ 2024-07-21

每月77次下载
用于10个crate(直接使用7个)

AGPL-3.0-or-later

65KB
1.5K SLoC

clockwork-cron

一个在Solana运行时安全使用的cron表达式解析器。与稳定的Rust v1.28.0版本兼容。

use clockwork_cron::Schedule;
use chrono::{DateTime, NaiveDateTime, Utc};
use std::str::FromStr;

fn main() {
  //               sec  min   hour   day of month   month   day of week   year
  let expression = "0   30   9,12,15     1,15       May-Aug  Mon,Wed,Fri  2018/2";
  let schedule = Schedule::from_str(expression).unwrap();
  let ts = 1234567890;
  let next_ts = schedule
      .after(&DateTime::<Utc>::from_utc(
          NaiveDateTime::from_timestamp(ts, 0),
          Utc,
      ))
      .take(1)
      .next()
    {
        Some(datetime) => Some(datetime.timestamp()),
        None => None,
    }
}

/*
Upcoming fire times:
-> 2018-06-01 09:30:00 UTC
-> 2018-06-01 12:30:00 UTC
-> 2018-06-01 15:30:00 UTC
-> 2018-06-15 09:30:00 UTC
-> 2018-06-15 12:30:00 UTC
-> 2018-06-15 15:30:00 UTC
-> 2018-08-01 09:30:00 UTC
-> 2018-08-01 12:30:00 UTC
-> 2018-08-01 15:30:00 UTC
-> 2018-08-15 09:30:00 UTC
*/

⚠️ 语法

sec  min   hour   day of month   month   day of week   year

如果您使用如crontab guru之类的工具,请注意clockwork解析器是一个具有7列的字符串。您可能需要添加秒(最左侧列),并且可以可选地添加年(最右侧列)。例如以下5列cron

分钟 小时 月份中的日期 月份 星期中的日期
0 18 * *

变为

分钟 小时 月份中的日期 月份 星期中的日期
0 0 18 * * *

分钟 小时 月份中的日期 月份 星期中的日期
0 0 18 * *

这些也是支持的

"@yearly"
"@weekly"
"@daily"
"@hourly"

依赖项

~2.5MB
~37K SLoC