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

sablier-cron

A cron expression parser that's safe to use in the Solana runtime

8 releases (4 stable)

1.2.1 Oct 10, 2024
1.2.0 Oct 9, 2024
1.1.0 Sep 30, 2024
1.0.0-alpha.3 Apr 26, 2024
1.0.0-alpha.1 Feb 23, 2024

#16 in #month

Download history 6/week @ 2024-07-15 40/week @ 2024-07-29 4/week @ 2024-08-26 399/week @ 2024-09-02 4/week @ 2024-09-09 53/week @ 2024-09-16 20/week @ 2024-09-23 214/week @ 2024-09-30 376/week @ 2024-10-07 26/week @ 2024-10-14

637 downloads per month
Used in 3 crates (2 directly)

AGPL-3.0-or-later

65KB
1.5K SLoC

sablier-cron

A cron expression parser that's safe to use in the Solana runtime. Works with stable 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
*/

⚠️ Syntax

sec  min   hour   day of month   month   day of week   year

If you use tools such as crontab guru, note that the clockwork parser is a 7 columns string. You probably need to add the seconds (left most column) and can optionally add the year (right most column). e.g. the following 5 columns cron:

min hour day of month month day of week
0 18 * * FRI

becomes

sec min hour day of month month day of week year
0 0 18 _ _ FRI *

or

sec min hour day of month month day of week
0 0 18 * * FRI

These are also supported:

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

Dependencies

~2MB
~37K SLoC