Component Name

VJOURNAL

Purpose

Provide a grouping of component properties that describe a journal entry.

Format Definition

A "VJOURNAL" calendar component is defined by the following notation:

 journalc   = "BEGIN" ":" "VJOURNAL" CRLF
              jourprop
              "END" ":" "VJOURNAL" CRLF

 jourprop   = *(
            ;
            ; The following are REQUIRED,
            ; but MUST NOT occur more than once.
            ;
            dtstamp / uid /
            ;
            ; The following are OPTIONAL,
            ; but MUST NOT occur more than once.
            ;
            class / created / dtstart /
            last-mod / organizer / recurid / seq /
            status / summary / url /
            ;
            ; The following is OPTIONAL,
            ; but SHOULD NOT occur more than once.
            ;
            rrule /
            ;
            ; The following are OPTIONAL,
            ; and MAY occur more than once.
            ;
            attach / attendee / categories / comment /
            contact / description / exdate / related / rdate /
            rstatus / x-prop / iana-prop
            ;
            )

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. The "VJOURNAL" calendar component can also be used to associate a document with a calendar date.

The "VJOURNAL" calendar component does not take up time on a calendar. Hence, it does not play a role in free or busy time searches -- it is as though it has a time transparency value of TRANSPARENT. It is transparent to any such searches.

The "VJOURNAL" calendar component cannot be nested within another calendar component. However, "VJOURNAL" calendar components can be related to each other or to a "VEVENT" or to a "VTODO" calendar component, with the "RELATED-TO" property.

Example

The following is an example of the "VJOURNAL" calendar component:

 BEGIN:VJOURNAL
 UID:19970901T130000Z-123405@example.com
 DTSTAMP:19970901T130000Z
 DTSTART;VALUE=DATE:19970317
 SUMMARY:Staff meeting minutes
 DESCRIPTION:1. Staff meeting: Participants include Joe\,
   Lisa\, and Bob. Aurora project plans were reviewed.
   There is currently no budget reserves for this project.
   Lisa will escalate to management. Next meeting on Tuesday.\n
  2. Telephone Conference: ABC Corp. sales representative
   called to discuss new printer. Promised to get us a demo by
   Friday.\n3. Henry Miller (Handsoff Insurance): Car was
   totaled by tree. Is looking into a loaner car. 555-2323
   (tel).
 END:VJOURNAL

This document was automatically converted to XHTML using an RFC to HTML converter with the original text document at the Internet Engineering Task Force web site at ietf.org .  The original text document should be referred to if there are any errors or discrepancies found in this document.

Need to test your iCalendar feeds? The iCalendar Validator provides developers and testers a method to validate their iCalendar feeds, which can take data from either a URL, file or text snippet and compare it against the RFC 5545 specification.  We believe we have one of the best iCalendar validation tools available on the internet. More information about the validator can be found here.