+ jJzRt^RIHt^RIt^RIHtHtHt^RIHtH t ^RI H t H t H t HtHtHtHtHtHtHtHtHtHtHtHtHtHtHtHtHtHtH t H!t!H"t"H#t#H$t$H%t%H&t&H't'H(t(H)t)H*t*H+t+H,t,H-t-H.t.H/t/H0t0^RI1H2t2^RI3H4t4]'d+^RI5H6t6H7t7^R I8H9t9^R I:H;t;^R It>H?t?^R I@HAtA^R IBHCtC!RR]24tDR.tER#)z:rfc:`5545` VEVENT component.) annotationsN)datedatetime timedelta) TYPE_CHECKINGLiteral)&CONCEPTS_TYPE_SETTERLINKS_TYPE_SETTERRELATED_TO_TYPE_SETTERREQUEST_STATUS_propertyX_MOZ_LASTACK_propertyX_MOZ_SNOOZE_TIME_propertyattendees_propertycategories_propertyclass_propertycolor_propertyconferences_propertycontacts_propertycreate_single_propertydescription_propertyexdates_propertyget_duration_propertyget_end_property&get_start_end_duration_with_validationget_start_propertyimages_propertylocation_propertyorganizer_propertypriority_propertyproperty_del_durationproperty_doc_duration_templateproperty_get_durationproperty_set_durationrdates_propertyrrules_propertysequence_propertyset_duration_with_lockingset_end_with_lockingset_start_with_lockingstatus_propertysummary_propertytransparency_property uid_property url_property) Component) get_example)IterableSequenceAlarms)Self)CLASSSTATUSTRANSP) vCalAddress) Conferencec Za]tRt^>tRtRtR%tR&tR'tR(t R)t Rt ] RRl4t ]R*RR ll4t]!RR ]]3]R 4t]!RR ]]3]R 4tR t] !]]]]P4!RR74t] RRl4t]P:RRl4t] RRl4t]P:RRl4t] RRl4t]P:RRl4tR+RRllt R,RRllt!R+RR llt"]#t$]%t&]'t(])t*]+t,]-t.]/t0]1t2]3t4]5t6]7t8]9t:];t<]=t>]?t@]AtB]CtD]EtF]GtH]ItJ]KtL]MtN]OtP^R!IQHRtR]R-R"V3R#lll4tSR$tTV;tU#).EventaA grouping of component properties that describe an event. Description: A "VEVENT" calendar component is a grouping of component properties, possibly including "VALARM" calendar components, that represents a scheduled amount of time on a calendar. For example, it can be an activity; such as a one-hour long, department meeting from 8:00 AM to 9:00 AM, tomorrow. Generally, an event will take up time on an individual calendar. Hence, the event will appear as an opaque interval in a search for busy time. Alternately, the event can have its Time Transparency set to "TRANSPARENT" in order to prevent blocking of the event in searches for busy time. The "VEVENT" is also the calendar component used to specify an anniversary or daily reminder within a calendar. These events have a DATE value type for the "DTSTART" property instead of the default value type of DATE-TIME. If such a "VEVENT" has a "DTEND" property, it MUST be specified as a DATE value also. The anniversary type of "VEVENT" can span more than one date (i.e., "DTEND" property value is set to a calendar date after the "DTSTART" property value). If such a "VEVENT" has a "DURATION" property, it MUST be specified as a "dur-day" or "dur-week" value. The "DTSTART" property for a "VEVENT" specifies the inclusive start of the event. For recurring events, it also specifies the very first instance in the recurrence set. The "DTEND" property for a "VEVENT" calendar component specifies the non-inclusive end of the event. For cases where a "VEVENT" calendar component specifies a "DTSTART" property with a DATE value type but no "DTEND" nor "DURATION" property, the event's duration is taken to be one day. For cases where a "VEVENT" calendar component specifies a "DTSTART" property with a DATE-TIME value type but no "DTEND" property, the event ends on the same calendar date and time of day specified by the "DTSTART" property. The "VEVENT" calendar component cannot be nested within another calendar component. However, "VEVENT" calendar components can be related to each other or to a "VTODO" or to a "VJOURNAL" calendar component with the "RELATED-TO" property. Examples: The following is an example of the "VEVENT" calendar component used to represent a meeting that will also be opaque to searches for busy time: .. code-block:: ics BEGIN:VEVENT UID:19970901T130000Z-123401@example.com DTSTAMP:19970901T130000Z DTSTART:19970903T163000Z DTEND:19970903T190000Z SUMMARY:Annual Employee Review CLASS:PRIVATE CATEGORIES:BUSINESS,HUMAN RESOURCES END:VEVENT The following is an example of the "VEVENT" calendar component used to represent a reminder that will not be opaque, but rather transparent, to searches for busy time: .. code-block:: ics BEGIN:VEVENT UID:19970901T130000Z-123402@example.com DTSTAMP:19970901T130000Z DTSTART:19970401T163000Z DTEND:19970402T010000Z SUMMARY:Laurel is in sensitivity awareness class. CLASS:PUBLIC CATEGORIES:BUSINESS,HUMAN RESOURCES TRANSP:TRANSPARENT END:VEVENT The following is an example of the "VEVENT" calendar component used to represent an anniversary that will occur annually: .. code-block:: ics BEGIN:VEVENT UID:19970901T130000Z-123403@example.com DTSTAMP:19970901T130000Z DTSTART;VALUE=DATE:19971102 SUMMARY:Our Blissful Anniversary TRANSP:TRANSPARENT CLASS:CONFIDENTIAL CATEGORIES:ANNIVERSARY,PERSONAL,SPECIAL OCCASION RRULE:FREQ=YEARLY END:VEVENT The following is an example of the "VEVENT" calendar component used to represent a multi-day event scheduled from June 28th, 2007 to July 8th, 2007 inclusively. Note that the "DTEND" property is set to July 9th, 2007, since the "DTEND" property specifies the non-inclusive end of the event. .. code-block:: ics BEGIN:VEVENT UID:20070423T123432Z-541111@example.com DTSTAMP:20070423T123432Z DTSTART;VALUE=DATE:20070628 DTEND;VALUE=DATE:20070709 SUMMARY:Festival International de Jazz de Montreal TRANSP:TRANSPARENT END:VEVENT Create a new Event: .. code-block:: python >>> from icalendar import Event >>> from datetime import datetime >>> event = Event.new(start=datetime(2021, 1, 1, 12, 30, 0)) >>> print(event.to_ical()) BEGIN:VEVENT DTSTART:20210101T123000 DTSTAMP:20250517T080612Z UID:d755cef5-2311-46ed-a0e1-6733c9e15c63 END:VEVENT VEVENTDTSTARTDTENDTcV^8dQhRR/#)returnr3)formats"R/home/ralf/ical-fahrzeuge/venv/lib/python3.14/site-packages/icalendar/cal/event.py __annotate__Event.__annotate__sc ^RIHpV!V4#)aCompute the alarm times for this component. >>> from icalendar import Event >>> event = Event.example("rfc_9074_example_1") >>> len(event.alarms.times) 1 >>> alarm_time = event.alarms.times[0] >>> alarm_time.trigger # The time when the alarm pops up datetime.datetime(2021, 3, 2, 10, 15, tzinfo=ZoneInfo(key='America/New_York')) >>> alarm_time.is_active() # This alarm has not been acknowledged True Note that this only uses DTSTART and DTEND, but ignores RDATE, EXDATE, and RRULE properties. r2)icalendar.alarmsr3)selfr3s& rDalarms Event.alarmss" ,d|rGc V^8dQhRRRR/#)r@namestrrAr;rB)rCs"rDrErFs::3:%:rGc 8VP\RV44#)z0Return the calendar example with the given name.events) from_icalr/)clsrNs&&rDexample Event.example s}}[4899rGdtzQThe "DTSTART" property for a "VEVENT" specifies the inclusive start of the event.zdThe "DTEND" property for a "VEVENT" calendar component specifies the non-inclusive end of the event.c \VRRR4#)z=Verify the calendar validity and return the right attributes.r=r>r<)rrJs&rD_get_start_end_durationEvent._get_start_end_duration!s5 )Wh  rG) componentcV^8dQhRR/#)r@rArrB)rCs"rDrErF/s++)+rGc \V4#)aThe duration of the VEVENT. Returns the DURATION property if set, otherwise calculated from start and end. When setting duration, the end time is automatically calculated from start + duration. You can set the duration to automatically adjust the end time while keeping start locked. Setting the duration will do the following. 1. Keep the start time locked (unchanged) 2. Adjust the end time to start + duration 3. Remove any existing DTEND property 4. Set the DURATION property )rrXs&rDdurationEvent.duration.s$%T**rGcV^8dQhRR/#)r@valuerrB)rCs"rDrErFCs11i1rGc \V\4'g#\R\V4P R24hVP VRR7R#)zUse timedelta, not .start)lockedN) isinstancer TypeErrortype__name__ set_duration)rJras&&rDr^r_BsD%++1$u+2F2F1GqIJ J %0rGcV^8dQhRR/#r@rAdate | datetimerB)rCs"rDrErFKs(((rGc \V4#)adThe start of the event. Invalid values raise an :exc:`~icalendar.error.InvalidCalendar`. If there is no start, we also raise an :exc:`~icalendar.error.IncompleteComponent` error. You can get the start, end and duration of an event as follows: >>> from datetime import datetime >>> from icalendar import Event >>> event = Event() >>> event.start = datetime(2021, 1, 1, 12) >>> event.end = datetime(2021, 1, 1, 12, 30) # 30 minutes >>> event.duration # 1800 seconds == 30 minutes datetime.timedelta(seconds=1800) >>> print(event.to_ical()) BEGIN:VEVENT DTSTART:20210101T120000 DTEND:20210101T123000 END:VEVENT )rrXs&rDrd Event.startJs,"$''rGcV^8dQhRR/#)r@rddate | datetime | NonerB)rCs"rDrErFcs1rGc WnR#)zSet the start.N)r=)rJrds&&rDrdrobs  rGcV^8dQhRR/#rlrB)rCs"rDrErFhs//_/rGc \VR4#)zThe end of the event. Invalid values raise an :exc:`~icalendar.error.InvalidCalendar` error. If there is no end, we also raise an :exc:`~icalendar.error.IncompleteComponent` error. r>)rrXs&rDend Event.endgs g..rGcV^8dQhRR/#)r@rurqrB)rCs"rDrErFqs-rGc WnR#)z Set the end.N)r>)rJrus&&rDrurvps  rGc V^8dQhRRRR/#)r@r^ztimedelta | NonerezLiteral['start', 'end']rB)rCs"rDrErFus C C( C2I CrGc \WVR4R#)zSet the duration of the event relative to either start or end. Parameters: duration: The duration to set, or None to convert to DURATION property locked: Which property to keep unchanged ('start' or 'end') r>N)r&)rJr^res&&&rDrjEvent.set_durationus "$&'BrGc V^8dQhRRRR/#)r@rdrmrez!Literal['duration', 'end'] | NonerB)rCs"rDrErFs = =$ =.O =rGc \WVR4R#)zSet the start and keep the duration or end of the event. Parameters: start: The start time to set locked: Which property to keep unchanged ('duration', 'end', or None for auto-detect) r>N)r()rJrdres&&&rD set_startEvent.set_starts tFGN)r')rJrures&&&rDset_end Event.set_ends T8rG) RECURRENCE_IDc<V^8dQhRRRRRRRRR R R R R RRR RRRRRRRRRRRRRRRRRRRR RR R!R R"RR#RR$RR%R&R'R(R)R*R+RR,R-R.RR/R0/#)1r@ attendeeszlist[vCalAddress] | None categoriesz Sequence[str]classificationz CLASS | Nonecolorz str | Nonecommentszlist[str] | str | Noneconceptsr conferenceszlist[Conference] | Nonecontactscreatedz date | None descriptionrurq last_modifiedlinksr location organizerzvCalAddress | str | Nonepriorityz int | None recurrence_idrefids related_tor request_statussequencestamprdstatusz STATUS | None subcomponentszIterable[Component] | None transparencyz TRANSP | Nonesummaryuidzstr | uuid.UUID | NoneurlrAr4rB)rCs"rDrErFsZpp,p" p % p  p)p'p-p)pp p$p#p!p !p",#p$%p&.'p(')p*++p,/-p./p01p2&3p45p627p8$9p:;p<$=p>?p@ AprGc  <\ST`VeTMVP4V V VV VVVVR7 pVVnV VnVeTM\ P !4VnVVnV Vn VVn VVn VVn VVn VVnVVnVVnVVnVVnVVnVVnVVnVVnVVnVVnVP2'dVP5VV 4V#)aCreate a new event with the required properties of ``stamp`` and ``uid``. This creates a new ``Event`` in accordance with :rfc:`5545#section-3.6.1`. Parameters: attendees: The :attr:`attendees` of the event. categories: The :attr:`categories` of the event. classification: The :attr:`classification` of the event. color: The :attr:`color` of the event. comments: The :attr:`~icalendar.Component.comments` of the event. concepts: The :attr:`~icalendar.Component.concepts` of the event. conferences: The :attr:`conferences` of the event. created: The :attr:`~icalendar.Component.created` of the event. description: The :attr:`description` of the event. end: The :attr:`end` of the event. last_modified: The :attr:`~icalendar.Component.last_modified` of the event. links: The :attr:`~icalendar.Component.links` of the event. location: The :attr:`location` of the event. organizer: The :attr:`organizer` of the event. priority: The :attr:`priority` of the event. recurrence_id: The :attr:`RECURRENCE_ID` of the event. refids: :attr:`~icalendar.Component.refids` of the event. related_to: :attr:`~icalendar.Component.related_to` of the event. request_status: The :attr:`REQUEST_STATUS` of the event. sequence: The :attr:`sequence` of the event. stamp: The :attr:`~icalendar.Component.stamp` of the event. If ``None``, this is set to the current UTC time. start: The :attr:`start` of the event. status: The :attr:`status` of the event. subcomponents: The subcomponents of the event. summary: The :attr:`summary` of the event. transparency: The :attr:`transparency` of the event. uid: The :attr:`uid` of the event. If ``None``, this is set to a new :func:`uuid.uuid4`. url: The :attr:`url` of the event. Returns: :class:`Event` Raises: :exc:`~icalendar.error.InvalidCalendar`: If the content is not valid according to :rfc:`5545`. .. warning:: As time progresses, we will be stricter with the validation. ) rrrrrrrrr)supernew_utc_nowrruuiduuid4rrdrurrrrrrrrrrrREQUEST_STATUSrrr _validate_new_validate_start_and_end) rSrrrrrrrrrrrurrrrrrrrrrrrdrrrrrrevent __class__s "&&&&&&&&&&&&&&&&&&&&&&&&&&&&& rDr Event.news^gk ,%#,,.'!'"    '?C     %!- #!!)! -#'+      ' 's 3 rG)r>r=) SUMMARYr=r>DURATIONDTSTAMPUID RECURRENCE-IDSEQUENCERRULERDATEEXDATE)rr)r5CREATEDCOLOR DESCRIPTIONr=GEOz LAST-MODIFIEDLOCATION ORGANIZERPRIORITYrrr6rr7URLrr>rr)r>r) ATTACHATTENDEE CATEGORIESCOMMENTCONTACTrzREQUEST-STATUSRELATED RESOURCESrr)rfc_9074_example_3)rd)N)NrBNNNNNNNNNNNNNNNNNNNNNNNNNNN)Vri __module__ __qualname____firstlineno____doc__rNcanonical_orderrequired singletons exclusivemultipleignore_exceptionspropertyrK classmethodrTrrrr=r>rYr!r"rr rCrr^setterrdrurjr~rr X_MOZ_SNOOZE_TIMEr X_MOZ_LASTACKrrr%rrrr#rdatesrexdatesr$rrulesr rr,rr*rrrrrr-rrrrrrrrrr+rr)rrrrimagesrricalendar.attrrr__static_attributes__ __classcell__)rs@rDr;r;>szx D OHJ,I H (::% 4 [ G # 4 n  E &--A H++&__11((. \\// ZZ C = 93*M E H$J FG F,N CG&K#N C"I H H H(L F"I F&K,ppprGr;)Fr __future__rrrrrtypingrrrrr r r r r rrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-icalendar.cal.componentr.icalendar.cal.examplesr/collections.abcr0r1rIr3icalendar.compatibilityr4icalendar.enumsr5r6r7icalendar.propr8icalendar.prop.conferencer9r;__all__rBrGrDrs#" ..)''''''''''P..2',55*4cIcL )rG