Deprecated
Use java. for iCalendar DATE representations.
Note
iCal4j calculates the timezone of Date objects by default. In the iCalendar specification a DATE object doesn't really have a timezone associated with it, but in the ical4j implementation it does (as it is based on a java.util.Date object). An unfortunate side effect of this is that a Date object can be affected by daylight savings rules for the associated timezone. So currently ical4j offers two approaches to setting the timezone:
By default option 1 is used, but you can override this with the following flag in the ical4j.properties file:
net.fortuna.ical4j.timezone.date.floating=true
Alternatively you can avoid using the constructor that accepts a java.util.Date object, and instead provide a date string value. This should always display the correct value, however when the local timezone is used any calculations (recurrences, etc.) may still be affect by DST rules.
Extract from RFC5545:
3.3.4. Date Value Name: DATE Purpose: This value type is used to identify values that contain a calendar date. Format Definition: This value type is defined by the following notation: date = date-value date-value = date-fullyear date-month date-mday date-fullyear = 4DIGIT date-month = 2DIGIT ;01-12 date-mday = 2DIGIT ;01-28, 01-29, 01-30, 01-31 ;based on month/year Description: If the property permits, multiple "date" values are specified as a COMMA-separated list of values. The format for the value type is based on the [ISO.8601.2004] complete representation, basic format for a calendar date. The textual format specifies a four-digit year, two-digit month, and two-digit day of the month. There are no separator characters between the year, month, and day component text. No additional content value encoding (i.e., BACKSLASH character encoding, see Section 3.3.11) is defined for this value type. Example: The following represents July 14, 1997: 19970714
| Modifier and Type | Field and Description |
|---|---|
| private static final String | |
| private static final long | |
| private static final String |
| Access | Constructor and Description |
|---|---|
| public | |
| protected | |
| public | |
| protected | |
| public | |
| public | |
| public | |
| public |
| DEFAULT_PATTERN | back to summary |
|---|---|
| private static final String DEFAULT_PATTERN | |
| serialVersionUID | back to summary |
|---|---|
| private static final long serialVersionUID | |
| VCARD_PATTERN | back to summary |
|---|---|
| private static final String VCARD_PATTERN | |
| Date | back to summary |
|---|---|
| public Date() Default constructor. | |
| Date | back to summary |
|---|---|
| protected Date(final int precision, TimeZone tz) Creates a new date instance with the specified precision. This constructor is only intended for use by sub-classes.
| |
| Date | back to summary |
|---|---|
public Date(final long time)
| |
| Date | back to summary |
|---|---|
| protected Date(final long time, final int precision, TimeZone tz) Creates a new date instance with the specified precision. This constructor is only intended for use by sub-classes.
| |
| Date | back to summary |
|---|---|
public Date(final Calendar calendar)
| |
| Date | back to summary |
|---|---|
public Date(final Date date)
| |
| Date | back to summary |
|---|---|
public Date(final String value) throws ParseException
| |
| Date | back to summary |
|---|---|
public Date(String value, String pattern) throws ParseException
| |