public class DtEnd<T extends Temporal> extends DateProperty<T>
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 typeExamples:
// 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());
Modifier and Type | Class and Description |
---|---|
static class |
DtEnd.Factory |
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 and Description |
---|
DtEnd()
Default constructor.
|
DtEnd(ParameterList aList,
String aValue) |
DtEnd(ParameterList aList,
T aDate)
Constructor.
|
DtEnd(String value)
Creates a new instance initialised with the parsed value.
|
DtEnd(T aDate)
Constructor.
|
DtEnd(T time,
boolean utc)
Deprecated.
UTC time is now specified via the generic type (i.e.
Instant ) |
Modifier and Type | Method and Description |
---|---|
Property |
copy()
Create a (deep) copy of this property.
|
getDate, getValue, hashCode, isUtc, setDate, setValue, validate
equals, getName, getParameter, getParameters, getParameters, toString
public DtEnd()
public DtEnd(String value) throws ParseException
value
- the DTEND value string to parseParseException
- where the specified string is not a valid DTEND value representationpublic DtEnd(ParameterList aList, String aValue)
aList
- a list of parameters for this componentaValue
- a value string for this componentParseException
- when the specified string is not a valid date/date-time representationpublic DtEnd(T aDate)
aDate
- a date@Deprecated public DtEnd(T time, boolean utc)
Instant
)time
- the time of the DtEndutc
- specifies whether time is UTCpublic DtEnd(ParameterList aList, T aDate)
aList
- a list of parameters for this componentaDate
- a date