Struct CronExpr 

pub struct CronExpr { /* private fields */ }

A parsed cron expression ready for next-run calculations.

Used when upserting chronon_core::Job rows with chronon_core::ScheduleKind::Cron: set job.cron_expr (and optional timezone); CoordinatorService::upsert_job calls Self::parse and stores next_run_at.

Syntax: standard five-field cron (minute hour day-of-month month day-of-week). An optional sixth field enables seconds (CronExpr::has_seconds). Timezone names follow chrono-tz (e.g. "America/New_York"); omit for UTC.

Examples

use chronon_scheduler::CronExpr;

let cron = CronExpr::parse("0 2 * * *", Some("UTC")).unwrap();
assert_eq!(cron.expression(), "0 2 * * *");
assert!(!cron.has_seconds());
assert!(cron.next_from_now().is_some());

let with_secs = CronExpr::parse("0 0 2 * * *", None).unwrap();
assert!(with_secs.has_seconds());

Implementations

impl CronExpr

pub fn parse( expr: &str, timezone: Option<&str>, ) -> Result<CronExpr, ChrononError>

Parse a cron expression with an optional timezone.

Examples

use chronon_scheduler::CronExpr;

let cron = CronExpr::parse("0 0 * * *", None).unwrap();
assert_eq!(cron.expression(), "0 0 * * *");
assert!(cron.next_from_now().is_some());

pub fn next_after(&self, after: DateTime<Utc>) -> Option<DateTime<Utc>>

Calculate the next run time after the given datetime.

pub fn next_from_now(&self) -> Option<DateTime<Utc>>

Calculate the next run time from now.

pub fn expression(&self) -> &str

Get the original cron expression.

pub fn timezone(&self) -> &Tz

Get the timezone.

pub fn has_seconds(&self) -> bool

Check if the expression uses seconds (6 fields).

Trait Implementations

impl Clone for CronExpr

fn clone(&self) -> CronExpr

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CronExpr

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.