Struct RecurrenceRule 

#[non_exhaustive]
pub struct RecurrenceRule {

    pub at_type: String,
    pub frequency: String,
    pub interval: Option<u64>,
    pub rscale: Option<String>,
    pub skip: Option<String>,
    pub first_day_of_week: Option<String>,
    pub by_day: Option<Vec<NDay>>,
    pub by_month_day: Option<Vec<i32>>,
    pub by_month: Option<Vec<String>>,
    pub by_year_day: Option<Vec<i32>>,
    pub by_week_no: Option<Vec<i32>>,
    pub by_hour: Option<Vec<u8>>,
    pub by_minute: Option<Vec<u8>>,
    pub by_second: Option<Vec<u8>>,
    pub by_set_position: Option<Vec<i32>>,
    pub count: Option<u64>,
    pub until: Option<LocalDateTime>,
    pub extra: Map<String, Value>,
}

A recurrence rule as defined in RFC 8984 §4.3.3.

Used in recurrenceRules and excludedRecurrenceRules of a CalendarEvent (from jmap-calendars-types).

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

at_type: String

Object type discriminator; always "RecurrenceRule" on the wire.

Deserialize is liberal: if @type is absent (spec-violating vendor input), this field defaults to "RecurrenceRule" rather than failing the whole parent object’s deserialize. Serialize always emits the field. See bd:JMAP-ky8g.10.

frequency: String

Recurrence frequency: "yearly", "monthly", "weekly", "daily", "hourly", "minutely", or "secondly".

interval: Option<u64>

Interval between recurrences (≥ 1; default 1).

rscale: Option<String>

Calendar system (default "gregorian").

skip: Option<String>

How to handle skipped dates: "omit", "backward", "forward".

first_day_of_week: Option<String>

First day of week (default "mo"): "mo"–"su".

by_day: Option<Vec<NDay>>

Specific days within the frequency period.

by_month_day: Option<Vec<i32>>

Specific days of the month (±1–±31).

by_month: Option<Vec<String>>

Specific months (e.g. "1"–"12", optionally suffixed with "L").

by_year_day: Option<Vec<i32>>

Specific days of the year (±1–±366).

by_week_no: Option<Vec<i32>>

Specific weeks of the year (±1–±53).

by_hour: Option<Vec<u8>>

Specific hours (0–23).

by_minute: Option<Vec<u8>>

Specific minutes (0–59).

by_second: Option<Vec<u8>>

Specific seconds (0–60).

by_set_position: Option<Vec<i32>>

Filter by position within the set (positive = from start, negative = from end).

count: Option<u64>

Maximum number of occurrences.

until: Option<LocalDateTime>

The recurrence ends on or before this LocalDateTime (RFC 8984 §4.3.3 — until is a LocalDateTime, NOT a UTC date-time).

extra: Map<String, Value>

Catch-all for vendor / site / private extension fields not covered by the typed fields above. Preserves unknown fields across deserialize/serialize round-trip per workspace extras-preservation policy (see workspace AGENTS.md).

Trait Implementations

impl Clone for RecurrenceRule

fn clone(&self) -> RecurrenceRule

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RecurrenceRule

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RecurrenceRule

fn deserialize<__D>( __deserializer: __D, ) -> Result<RecurrenceRule, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for RecurrenceRule

impl PartialEq for RecurrenceRule

fn eq(&self, other: &RecurrenceRule) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for RecurrenceRule

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RecurrenceRule