Class DtStart<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.DtStart<T>
-
- All Implemented Interfaces:
Serializable
,Comparable<Property>
,FluentProperty
public class DtStart<T extends Temporal> extends DateProperty<T>
$Id$ Created: [Apr 6, 2004] Defines a DTSTART iCalendar component property.4.8.2.4 Date/Time Start Property Name: DTSTART Purpose: This property specifies when the calendar component begins. Value Type: The default value type is DATE-TIME. The time value MUST be one of the forms defined for the DATE-TIME value type. 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 the "VEVENT", "VTODO", "VFREEBUSY", or "VTIMEZONE" calendar components. Description: Within the "VEVENT" calendar component, this property defines the start date and time for the event. The property is REQUIRED in "VEVENT" calendar components. Events can have a start date/time but no end date/time. In that case, the event does not take up any time. Within the "VFREEBUSY" calendar component, this property defines the start date and time for the free or busy time information. The time MUST be specified in UTC time. Within the "VTIMEZONE" calendar component, this property defines the effective start date and time for a time zone specification. This property is REQUIRED within each STANDARD and DAYLIGHT part included in "VTIMEZONE" calendar components and MUST be specified as a local DATE-TIME without the "TZID" property parameter. Format Definition: The property is defined by the following notation: dtstart = "DTSTART" dtstparam ":" dtstval CRLF dtstparam = *( ; 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) ) dtstval = date-time / date ;Value MUST match value type
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
DtStart.Factory<T extends Temporal>
-
Field Summary
-
Fields inherited from class net.fortuna.ical4j.model.Property
ACKNOWLEDGED, ACTION, ATTACH, ATTENDEE, BUSYTYPE, CALENDAR_ADDRESS, 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, PARTICIPANT_TYPE, PERCENT_COMPLETE, POSTALCODE, PRIORITY, PRODID, PROXIMITY, RDATE, RECURRENCE_ID, REGION, RELATED_TO, REPEAT, REQUEST_STATUS, RESOURCE_TYPE, RESOURCES, RRULE, SEQUENCE, STATUS, STREET_ADDRESS, STRUCTURED_DATA, STYLED_DESCRIPTION, SUMMARY, TEL, TRANSP, TRIGGER, TZID, TZID_ALIAS_OF, TZNAME, TZOFFSETFROM, TZOFFSETTO, TZUNTIL, TZURL, UID, URL, VERSION
-
-
Constructor Summary
Constructors Constructor Description DtStart()
Default constructor.DtStart(String aValue)
DtStart(ParameterList aList, String aValue)
DtStart(ParameterList aList, T aDate)
Constructor.DtStart(T aDate)
Constructor.DtStart(T time, boolean utc)
Deprecated.UTC time is now specified via the generic type (i.e.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected PropertyFactory<DtStart<T>>
newFactory()
Returns a new property factory used to create deep copies.-
Methods inherited from class net.fortuna.ical4j.model.property.DateProperty
compareTo, getDate, getValue, hashCode, isUtc, setDate, setTimeZoneRegistry, setValue, validate
-
Methods inherited from class net.fortuna.ical4j.model.Property
add, copy, equals, getFluentTarget, getName, getParameter, getParameterList, getParameters, getRequiredParameter, remove, removeAll, replace, setParameters, toString
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface net.fortuna.ical4j.model.FluentProperty
withParameter
-
-
-
-
Constructor Detail
-
DtStart
public DtStart()
Default constructor. The time value is initialised to the time of instantiation.
-
DtStart
public DtStart(String aValue)
- Parameters:
aValue
- a value string for this component- Throws:
DateTimeParseException
- where the specified value string is not a valid date-time/date representation
-
DtStart
public DtStart(ParameterList aList, String aValue)
- Parameters:
aList
- a list of parameters for this componentaValue
- a value string for this component- Throws:
DateTimeParseException
- where the specified value string is not a valid date-time/date representation
-
DtStart
public DtStart(T aDate)
Constructor. Date or Date-Time format is determined based on the presence of a VALUE parameter.- Parameters:
aDate
- a date
-
DtStart
@Deprecated public DtStart(T time, boolean utc)
Deprecated.UTC time is now specified via the generic type (i.e.Instant
)Constructs a new DtStart with the specified time.- Parameters:
time
- the time of the DtStartutc
- specifies whether time is UTC
-
DtStart
public DtStart(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 componentaDate
- a date
-
-
Method Detail
-
newFactory
protected PropertyFactory<DtStart<T>> newFactory()
Description copied from class:Property
Returns a new property factory used to create deep copies.- Specified by:
newFactory
in classProperty
- Returns:
- a property factory instance
-
-