Struct CalendarSchedule 

pub struct CalendarSchedule { /* private fields */ }

A recurring calendar schedule anchored to its original local date and time.

Days, weeks, months, and years use the origin’s timezone. Time-only spans use elapsed time. Each occurrence is calculated from the original origin, so DST adjustments and month-end clamping do not shift later occurrences. The schedule supplies UTC deadlines and owns no clock, callbacks, or timer lifecycle state.

Implementations

impl CalendarSchedule

pub fn new(origin: &Zoned, span: Span) -> Result<Self>

Creates a schedule with a positive span and a timezone-aware origin.

The origin retains its civil date, wall-clock time, timezone, and selected offset in a DST fold. Jiff’s compatible disambiguation resolves later DST gaps and folds.

Errors

Returns an error if:

• The span is not positive.
• The origin is outside the [UnixNanos] range.

Trait Implementations

impl Clone for CalendarSchedule

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CalendarSchedule

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

Formats the value using the given formatter.

impl TimerSchedule for CalendarSchedule

fn start_time_ns(&self) -> UnixNanos

Returns the nominal start timestamp, including an explicit UNIX epoch start.

fn next_after(&self, time_ns: UnixNanos, index: &mut u64) -> Option<UnixNanos>

Returns the first deadline strictly after time_ns, updating the occurrence index.