+ j%Rt^RIHt^RIt^RIHtHtHt^RIHt^RI H t H t H t H t HtHtHtHtHtHtHtHtHtHtHtHtHtHtHtHtHt^RIH t ^RI!H"t"^RI#H$t$]'d^R I%H&t&^R I'H(t(^R I)H*t*H+t+^R I,H-t-!R R] 4t.R.t/R#)z:rfc:`5545` VJOURNAL component.) annotationsN)datedatetime timedelta) TYPE_CHECKING)CONCEPTS_TYPE_SETTERLINKS_TYPE_SETTERRELATED_TO_TYPE_SETTERREQUEST_STATUS_propertyattendees_propertycategories_propertyclass_propertycolor_propertycontacts_propertycreate_single_propertydescriptions_propertyexdates_propertyimages_propertyorganizer_propertyrdates_propertyrrules_propertysequence_propertystatus_propertysummary_property uid_property url_property) Component) get_example)IncompleteComponent)Sequence)Self)CLASSSTATUS) vCalAddressca]tRt^,tRtRtRtRtRt] !RR] ] 3] R4t ] RRl4t]PRR l4t]t] R R l4t]t]t]t]t]t]t]t] t!]"t#]$t%]&t'](t)]*t+],t-].t/]0t1^R I2H3t3] R Rl4t4]4PRRl4t4]4PjR4t4]6t7]8RRV3Rlll4t9]8RRRll4t:Rt;V;t<#)JournalaA descriptive text at a certain time or associated with a component. Description: A "VJOURNAL" calendar component is a grouping of component properties that represent one or more descriptive text notes associated with a particular calendar date. The "DTSTART" property is used to specify the calendar date with which the journal entry is associated. Generally, it will have a DATE value data type, but it can also be used to specify a DATE-TIME value data type. Examples of a journal entry include a daily record of a legislative body or a journal entry of individual telephone contacts for the day or an ordered list of accomplishments for the day. Examples: Create a new Journal: >>> from icalendar import Journal >>> journal = Journal.new() >>> print(journal.to_ical()) BEGIN:VJOURNAL DTSTAMP:20250517T080612Z UID:d755cef5-2311-46ed-a0e1-6733c9e15c63 END:VJOURNAL Get the example Journal. .. code-block:: pycon >>> from icalendar import Journal >>> journal = Journal.example() >>> print(journal.to_ical().decode()) BEGIN:VJOURNAL DESCRIPTION:Aurora project plans were reviewed. DTSTAMP:19970901T130000Z DTSTART;VALUE=DATE:19970317 SUMMARY:Staff meeting minutes UID:19970901T130000Z-123405@example.com END:VJOURNAL VJOURNALDTSTARTdtzjThe "DTSTART" property for a "VJOURNAL" that specifies the exact date at which the journal entry was made.cV^8dQhRR/#)returnr)formats"T/home/ralf/ical-fahrzeuge/venv/lib/python3.14/site-packages/icalendar/cal/journal.py __annotate__Journal.__annotate__s  t c <VPpVf \R4hV#)zThe start of the Journal. The "DTSTART" property is used to specify the calendar date with which the journal entry is associated. zNo DTSTART given.)r'r)selfstarts& r.r4 Journal.starts#  =%&9: : r1c V^8dQhRRRR/#)r*valuezdatetime | dater+Noner,)r-s"r.r/r0s?tr1c WnR#)zSet the start of the journal.N)r')r3r7s&&r.r4r5s  r1cV^8dQhRR/#)r*r+rr,)r-s"r.r/r0s)r1c \^4#)z*The journal has no duration: timedelta(0).)rr3s&r.durationJournal.durations|r1) RECURRENCE_IDcV^8dQhRR/#)r*r+strr,)r-s"r.r/r0s - -S -r1c PVPpV'gR#RPV4#)zxThe concatenated descriptions of the journal. A Journal can have several descriptions. This is a compatibility method. Nz ) descriptionsjoin)r3rCs& r. descriptionJournal.descriptions$(( |,,r1cV^8dQhRR/#)r*rE str | Noner,)r-s"r.r/r0s((z(r1c WnR#)zSet the descriptionNrC)r3rEs&&r.rErFs (r1c V=R#)zDelete all descriptions.NrJr<s&r.rErFs   r1c0xV^8dQhRRRRRRRRR R R R R R RRRRRRRRRRRRRR RRRR RRRRR RR!R"R#RR$R%R&RR'R(/#))r* attendeeszlist[vCalAddress] | None categoriesz Sequence[str]classificationz CLASS | NonecolorrHcommentszlist[str] | str | Noneconceptsrcontactscreatedz date | NonerEzstr | Sequence[str] | None last_modifiedlinksr organizerzvCalAddress | str | None recurrence_idzdate | datetime | Nonerefids related_tor request_statussequencez int | Nonestampr4statusz STATUS | Nonesummaryuidzstr | uuid.UUID | Noneurlr+r r,)r-s"r.r/r0s__,_" _ % _  _)_'_)__0_#_!_,_._ '!_"+#_$/%_&'_()_*&+_,-_./_0$1_23_4 5_r1c  p<\ST`VeTMVP4VV VV VVVR7pVVnV VnVeTM\ P !4VnVVnVVn VVn VVn VVn VVn V VnVVnVVnVVnVVnVVnV VnV#)aCreate a new journal entry with all required properties. This creates a new Journal in accordance with :rfc:`5545`. Parameters: attendees: The :attr:`attendees` of the journal. categories: The :attr:`categories` of the journal. classification: The :attr:`classification` of the journal. color: The :attr:`color` of the journal. comments: The :attr:`~icalendar.Component.comments` of the journal. concepts: The :attr:`~icalendar.Component.concepts` of the journal. contacts: The :attr:`contacts` of the journal. created: The :attr:`~icalendar.Component.created` of the journal. description: The :attr:`description` of the journal. last_modified: The :attr:`~icalendar.Component.last_modified` of the journal. links: The :attr:`~icalendar.Component.links` of the journal. organizer: The :attr:`organizer` of the journal. recurrence_id: The :attr:`RECURRENCE_ID` of the journal. refids: :attr:`~icalendar.Component.refids` of the journal. related_to: :attr:`~icalendar.Component.related_to` of the journal. request_status: The :attr:`REQUEST_STATUS` of the journal. sequence: The :attr:`sequence` of the journal. stamp: The :attr:`~icalendar.Component.stamp` of the journal. If None, this is set to the current time. start: The :attr:`start` of the journal. status: The :attr:`status` of the journal. summary: The :attr:`summary` of the journal. uid: The :attr:`uid` of the journal. If None, this is set to a new :func:`uuid.uuid4`. url: The :attr:`url` of the journal. Returns: :class:`Journal` Raises: ~error.InvalidCalendar: If the content is not valid according to :rfc:`5545`. .. warning:: As time progresses, we will be stricter with the validation. )r]rTrUrQrVrZrYrR)supernew_utc_nowr_rCuuiduuid4r`r4rPrNr\rOrarWrSr^REQUEST_STATUSrMr?)clsrMrNrOrPrQrRrSrTrErUrVrWrXrYrZr[r\r]r4r^r_r`rajournal __class__s"&&&&&&&&&&&&&&&&&&&&&&& r.rd Journal.newsJ  ,%#,,.'!$  "* _c$**,   '#!/ %# !/% -r1c V^8dQhRRRR/#)r*namerAr+r%r,)r-s"r.r/r0)s<<3rsg%" .. .../(,-*