biweekly.property

Class DateEnd

java.lang.Object

biweekly.property.ICalProperty

biweekly.property.ValuedProperty<ICalDate>

biweekly.property.DateOrDateTimeProperty

biweekly.property.DateEnd

public class DateEnd
extends DateOrDateTimeProperty

Defines the end date of an event or free/busy component.

Code sample (creating):

 VEvent event = new VEvent();
 
 //date and time
 Date datetime = ...
 DateEnd dtend = new DateEnd(datetime);
 event.setDateEnd(dtend);
 
 //date (without time component)
 Date date = ...
 dtend = new DateEnd(date, false);
 event.setDateEnd(dtend);
 

Code sample (reading):

 ICalendar ical = ...
 for (VEvent event : ical.getEvents()){
   DateEnd dtend = event.getDateEnd();
   
   //get property value (ICalDate extends java.util.Date)
   ICalDate value = dtend.getValue();
   
   if (value.hasTime()){
     //the value includes a time component
   } else {
     //the value is just a date
     //date object's time is set to "00:00:00" under local computer's default timezone
   }
   
   //gets the timezone that the property value was parsed under if you are curious about that
   TimeZone tz = tzinfo.getTimeZone(dtend);
 }
 

Code sample (using timezones):

 DateEnd dtend = new DateEnd(...);
 
 ICalendar ical = new ICalendar();
 VEvent event = new VEvent();
 event.setDateEnd(dtend);
 ical.addEvent(event);
 
 java.util.TimeZone tz = ...
 ICalWriter writer = new ICalWriter(...);
 
 //set the timezone of all date-time property values
 //date-time property values are written in UTC by default
 writer.getTimezoneInfo().setDefaultTimeZone(tz);
 
 //set the timezone just for this property
 writer.getTimezoneInfo().setTimeZone(dtend, tz);
 
 //finally, write the iCalendar object
 writer.write(ical);
 

Author:

Michael Angstadt

See Also:

RFC 5545 p.95-6, RFC 2445 p.91-2, vCal 1.0 p.31

Field Summary

Fields inherited from class biweekly.property.ValuedProperty

value

Fields inherited from class biweekly.property.ICalProperty

parameters

Constructor Summary

Constructors

Constructor and Description
DateEnd(Date endDate) Creates an end date property.
DateEnd(Date endDate, boolean hasTime) Creates an end date property.
DateEnd(ICalDate dateEnd) Creates an end date property.

Method Summary

Methods inherited from class biweekly.property.DateOrDateTimeProperty

setValue

Methods inherited from class biweekly.property.ValuedProperty

getValue, getValue, setValue, validate

Methods inherited from class biweekly.property.ICalProperty

addParameter, getParameter, getParameters, getParameters, removeParameter, setParameter, setParameter, setParameters, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DateEnd

public DateEnd(Date endDate)

Creates an end date property.

Parameters:

endDate - the end date

DateEnd

public DateEnd(Date endDate,
       boolean hasTime)

Creates an end date property.

Parameters:

endDate - the end date

hasTime - true if the value has a time component, false if it is strictly a date

DateEnd

public DateEnd(ICalDate dateEnd)

Creates an end date property.

Parameters:

dateEnd - the end date