Package net.fortuna.ical4j.model.property

Class DtEnd<T extends Temporal>

java.lang.Object

net.fortuna.ical4j.model.Content

net.fortuna.ical4j.model.Property

net.fortuna.ical4j.model.property.DateProperty<T>

net.fortuna.ical4j.model.property.DtEnd<T>

All Implemented Interfaces:

Serializable

public class DtEnd<T extends Temporal>
extends DateProperty<T>

$Id$

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());
 

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DtEnd.Factory<T extends Temporal>

Field Summary

Fields inherited from class net.fortuna.ical4j.model.Property

ACKNOWLEDGED, ACTION, ATTACH, ATTENDEE, BUSYTYPE, CALSCALE, CATEGORIES, CLASS, COMMENT, COMPLETED, CONTACT, COUNTRY, CREATED, DESCRIPTION, DTEND, DTSTAMP, DTSTART, DUE, DURATION, EXDATE, EXPERIMENTAL_PREFIX, EXRULE, EXTENDED_ADDRESS, FREEBUSY, GEO, LAST_MODIFIED, LOCALITY, LOCATION, LOCATION_TYPE, METHOD, NAME, ORGANIZER, PERCENT_COMPLETE, POSTALCODE, PRIORITY, PRODID, RDATE, RECURRENCE_ID, REGION, RELATED_TO, REPEAT, REQUEST_STATUS, RESOURCES, RRULE, SEQUENCE, STATUS, STREET_ADDRESS, SUMMARY, TEL, TRANSP, TRIGGER, TZID, TZNAME, TZOFFSETFROM, TZOFFSETTO, TZURL, UID, URL, VERSION

Constructor Summary

Constructors

Constructor	Description
DtEnd()	Default constructor.
DtEnd(String value)	Creates a new instance initialised with the parsed value.
DtEnd(ParameterList aList, String aValue)
DtEnd(ParameterList aList, T aDate)	Constructor.
DtEnd(T aDate)	Constructor.
DtEnd(T time, boolean utc)	Deprecated. UTC time is now specified via the generic type (i.e. Instant)

Method Summary

Modifier and Type	Method	Description
protected PropertyFactory<DtEnd<T>>	newFactory()	Returns a new property factory used to create deep copies.

Methods inherited from class net.fortuna.ical4j.model.property.DateProperty

getDate, getValue, hashCode, isUtc, setDate, setTimeZoneRegistry, setValue, validate

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from class net.fortuna.ical4j.model.Property

add, copy, equals, getName, getParameter, getParameters, getParameters, remove, removeAll, replace, setParameters, toString

Constructor Detail

DtEnd

public DtEnd()

Default constructor. The time value is initialised to the time of instantiation.

DtEnd

public DtEnd(String value)

Creates a new instance initialised with the parsed value.

Parameters:

value - the DTEND value string to parse

DtEnd

public DtEnd(ParameterList aList,
             String aValue)

Parameters:

aList - a list of parameters for this component

aValue - a value string for this component

DtEnd

public DtEnd(T aDate)

Constructor. Date or Date-Time format is determined based on the presence of a VALUE parameter.

Parameters:

aDate - a date

DtEnd

@Deprecated
public DtEnd(T time,
             boolean utc)

Deprecated. UTC time is now specified via the generic type (i.e. Instant)

Constructs a new DtEnd with the specified time.

Parameters:

time - the time of the DtEnd

utc - specifies whether time is UTC

DtEnd

public DtEnd(ParameterList aList,
             T aDate)

Constructor. Date or Date-Time format is determined based on the presence of a VALUE parameter.

Parameters:

aList - a list of parameters for this component

aDate - a date

Method Detail

newFactory

protected PropertyFactory<DtEnd<T>> newFactory()

Description copied from class: Property

Returns a new property factory used to create deep copies.

Specified by:

newFactory in class Property

Returns:

a property factory instance