jfxtras.icalendarfx.components.DaylightSavingTime Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jfxtras-icalendarfx Show documentation
There is a newer version: 17-r1
package jfxtras.icalendarfx.components;

import jfxtras.icalendarfx.components.DaylightSavingTime;
import jfxtras.icalendarfx.components.StandardOrDaylight;
import jfxtras.icalendarfx.components.VTimeZone;
import jfxtras.icalendarfx.properties.component.descriptive.Comment;
import jfxtras.icalendarfx.properties.component.misc.NonStandardProperty;
import jfxtras.icalendarfx.properties.component.recurrence.RecurrenceDates;
import jfxtras.icalendarfx.properties.component.recurrence.RecurrenceRule;
import jfxtras.icalendarfx.properties.component.time.DateTimeStart;
import jfxtras.icalendarfx.properties.component.timezone.TimeZoneName;
import jfxtras.icalendarfx.properties.component.timezone.TimeZoneOffsetFrom;
import jfxtras.icalendarfx.properties.component.timezone.TimeZoneOffsetTo;

/**
 * DAYLIGHT

 * Describes Daylight Saving Time

 * RFC 5545, 3.6.5, page 65
 * 
 * The DAYLIGHT sub-component is always a child of a VTIMEZONE calendar component.  It can't
 * exist alone.  The "STANDARD" or "DAYLIGHT" sub-component MUST
 * include the {@link DateTimeStart DTSTART}, {@link TimeZoneOffsetFrom TZOFFSETFROM},
 * and {@link TimeZoneOffsetTo TZOFFSETTO} properties.
 *
 * The "DAYLIGHT" sub-component consists of a collection of properties
 * that describe Daylight Saving Time.  In general, this collection
 * of properties consists of:
 *

 *the first onset DATE-TIME for the observance;
 *
the last onset DATE-TIME for the observance, if a last onset is
 *        known;
 *
the offset to be applied for the observance;
 *
a rule that describes the day and time when the observance
 *        takes effect;
 *
an optional name for the observance.
 *
 *
 *Properties available to this sub-component include:
 *

 *{@link Comment COMMENT}
 *
{@link DateTimeStart DTSTART}
 *
{@link RecurrenceDates RDATE}
 *
{@link RecurrenceRule RRULE}
 *
{@link TimeZoneName TZNAME}
 *
{@link TimeZoneOffsetFrom TZOFFSETFROM}
 *
{@link TimeZoneOffsetTo TZOFFSETTO}
 *
{@link NonStandardProperty X-PROP}
 *
 *
 * 
 * @author David Bal
 * 
 * @see VTimeZone
 *
 */
public class DaylightSavingTime extends StandardOrDaylight
{
	public final static String NAME = "DAYLIGHT";
    /*
     * CONSTRUCTORS
     */
    
    /**
     * Creates a default DaylightSavingTime calendar component with no properties
     */
    public DaylightSavingTime()
    {
        super();
    }

    /**
     * Creates a deep copy of a DaylightSavingTime calendar component
     */
    public DaylightSavingTime(DaylightSavingTime source)
    {
        super(source);
    }

    /**
     * Creates a new DaylightSavingTime calendar component by parsing a String of iCalendar content lines
     *
     * @param content  the text to parse, not null
     * @return  the parsed DaylightSavingTime
     */
    public static DaylightSavingTime parse(String content)
    {
    	return DaylightSavingTime.parse(new DaylightSavingTime(), content);
    }
}