Struct TimeZoneRule 

#[non_exhaustive]
pub struct TimeZoneRule {
    pub at_type: String,
    pub start: LocalDateTime,
    pub offset_from: UTCOffset,
    pub offset_to: UTCOffset,
    pub recurrence_rules: Option<Vec<RecurrenceRule>>,
    pub recurrence_overrides: Option<BTreeMap<LocalDateTime, PatchObject>>,
    pub names: Option<BTreeMap<String, bool>>,
    pub comments: Option<Vec<String>>,
    pub extra: Map<String, Value>,
}

A STANDARD or DAYLIGHT sub-component of a TimeZone (RFC 8984 §4.7.2).

Maps to a VTIMEZONE STANDARD or DAYLIGHT sub-component from iCalendar. At most one recurrence rule is allowed per rule.

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 "TimeZoneRule" on the wire.

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

start: LocalDateTime

DTSTART from iCalendar — the local date-time the rule first applies.

offset_from: UTCOffset

TZOFFSETFROM from iCalendar — the UTC offset in effect before the transition (format ±HHMM or ±HHMMSS). Typed as UTCOffset for consistency with the other temporal newtypes; the inner string is opaque to this crate (validation deferred to the backend per PLAN.md).

offset_to: UTCOffset

TZOFFSETTO from iCalendar — the UTC offset in effect after the transition (format ±HHMM or ±HHMMSS). Typed as UTCOffset for consistency with the other temporal newtypes.

recurrence_rules: Option<Vec<RecurrenceRule>>

RRULE from iCalendar — recurrence rules for the transition. Per RFC 8984 §4.7.2 the until value MUST be interpreted as a local time in the UTC time zone during evaluation.

recurrence_overrides: Option<BTreeMap<LocalDateTime, PatchObject>>

RDATE properties from iCalendar — additional explicit transition dates. Keys are LocalDateTime strings; the PatchObject value MUST be the empty JSON object ({}) per RFC 8984 §4.7.2.

The type permits non-empty PatchObject values that the wire spec forbids — this is deliberate for round-trip preservation of in-flight data. Consumers check that every value is the empty patch themselves (bd:JMAP-ops7.38).

names: Option<BTreeMap<String, bool>>

TZNAME properties from iCalendar — set of human-readable names for this rule. The map value MUST be true for each key.

comments: Option<Vec<String>>

COMMENT properties from iCalendar — order MUST be preserved.

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 TimeZoneRule

fn clone(&self) -> TimeZoneRule

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TimeZoneRule

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TimeZoneRule

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for TimeZoneRule

impl PartialEq for TimeZoneRule

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for TimeZoneRule

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 TimeZoneRule