#solana #cron-expression #expression-parser #month #run-time #schedule #safe

sablier-cron

一个在 Solana 运行时使用安全的 cron 表达式解析器

4 个版本

1.0.0-alpha.32024 年 4 月 26 日
1.0.0-alpha.22024 年 4 月 25 日
1.0.0-alpha.12024 年 2 月 23 日
1.0.0-alpha.02024 年 2 月 6 日

#1932 in 魔法豆

每月46次下载
3crate(2 个直接)中使用

AGPL-3.0 或更高版本

65KB
1.5K SLoC

sablier-cron

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

use sablier_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"

依赖项

~2MB
~37K SLoC