Created: [Apr 6, 2004]

Defines a DTEND iCalendar component property.

    4.8.2.2 Date/Time End

       Property Name: DTEND

       Purpose: This property specifies the date and time that a calendar
       component ends.

       Value Type: The default value type is DATE-TIME. The value type can
       be set to a DATE value type.

       Property Parameters: Non-standard, value data type, time zone
       identifier property parameters can be specified on this property.

       Conformance: This property can be specified in "VEVENT" or
       "VFREEBUSY" calendar components.

       Description: Within the "VEVENT" calendar component, this property
       defines the date and time by which the event ends. The value MUST be
       later in time than the value of the "DTSTART" property.

       Within the "VFREEBUSY" calendar component, this property defines the
       end date and time for the free or busy time information. The time
       MUST be specified in the UTC time format. The value MUST be later in
       time than the value of the "DTSTART" property.

       Format Definition: The property is defined by the following notation:

         dtend      = "DTEND" dtendparam":" dtendval CRLF

         dtendparam = *(

                    ; the following are optional,
                    ; but MUST NOT occur more than once

                    (";" "VALUE" "=" ("DATE-TIME" / "DATE")) /
                    (";" tzidparam) /

                    ; the following is optional,
                    ; and MAY occur more than once

                    (";" xparam)

                    )



         dtendval   = date-time / date
         ;Value MUST match value type

Examples:

     // construct an end date from a start date and a duration..
     DtStart start = ...
     Dur oneWeek = new Dur("1W");
     DtEnd end = new DtEnd(oneWeek.getTime(start.getDate());