#cron #schedule #repeat #periodic #time

cron_clock

A cron expression parser and schedule explorer. Rich documentation and case studies and related upper-level libraries are available.

11 releases

0.7.0 Apr 19, 2021
0.6.10 Mar 19, 2021
0.6.7 Feb 2, 2021
0.6.6 Nov 3, 2020
0.6.3 Jun 12, 2020

#2 in #repeat

Download history 38/week @ 2021-06-06 121/week @ 2021-06-13 368/week @ 2021-06-20 745/week @ 2021-06-27 474/week @ 2021-07-04 584/week @ 2021-07-11 919/week @ 2021-07-18 1403/week @ 2021-07-25 532/week @ 2021-08-01 475/week @ 2021-08-08 541/week @ 2021-08-15 787/week @ 2021-08-22 821/week @ 2021-08-29 814/week @ 2021-09-05 914/week @ 2021-09-12 693/week @ 2021-09-19

92 downloads per month
Used in delay_timer

MIT/Apache

74KB
2K SLoC

cron_clock

A cron expression parser. Works with stable Rust v1.28.0. The project is based on zslayton/cron, thank him very much.

In addition to the regular expressions, you can also use the following shortcut expressions with Schedule::from_str, such as @yearly @monthly @weekly @daily @hourly @minutely @secondly, make cron- Expression Iterator.

Tips

If you need a periodicized task manager, you may need delay-timer (Time-manager of delayed tasks. Like crontab, but synchronous asynchronous tasks are possible, and dynamic add/cancel/remove is supported) .

Example

extern crate cron;
extern crate chrono;

use cron::Schedule;
use chrono::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();
  println!("Upcoming fire times:");
  for datetime in schedule.upcoming(Utc).take(10) {
    println!("-> {}", datetime);
  }
}

/*
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
*/

Example shortcut expressions & ScheduleIteratorOwned

 extern crate chrono;
 extern crate cron_clock;

 use cron_clock::Schedule;
 use chrono::Utc;
 use std::str::FromStr;

 fn main() {
   // shortcut expressions
   let expression = "@hourly";
   let schedule = Schedule::from_str(expression).unwrap();
   println!("Upcoming fire times:");
   // `upcoming_owned` Get iterators with ownership, so you don't have lifetime to worry about.
   for datetime in schedule.upcoming_owned(Utc).take(10) {
     println!("-> {}", datetime);
   }
 }

License

Licensed under either of

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~1.5MB
~27K SLoC