Module ical4j.core

Package net.fortuna.ical4j.model.component

Class Observance

java.lang.Object

net.fortuna.ical4j.model.Content

net.fortuna.ical4j.model.Component

net.fortuna.ical4j.model.component.Observance

All Implemented Interfaces:

Serializable, Comparable<Component>, FluentComponent, PropertyContainer, PropertyListAccessor, Prototype<Component>, TimeZonePropertyAccessor

Direct Known Subclasses:

Daylight, Standard

public abstract class Observance
extends Component
implements TimeZonePropertyAccessor

$Id$ [05-Apr-2004]

Defines an iCalendar sub-component representing a timezone observance. Class made abstract such that only Standard and Daylight instances are valid.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class net.fortuna.ical4j.model.Content

Content.Factory

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DAYLIGHT	Token for daylight observance.
static final String	STANDARD	one of 'standardc' or 'daylightc' MUST occur and each MAY occur more than once.

Fields inherited from class net.fortuna.ical4j.model.Component

AVAILABLE, BEGIN, components, END, EXPERIMENTAL_PREFIX, PARTICIPANT, properties, VALARM, VAVAILABILITY, VEVENT, VFREEBUSY, VJOURNAL, VLOCATION, VRESOURCE, VTIMEZONE, VTODO, VVENUE

Fields inherited from interface net.fortuna.ical4j.model.PropertyContainer

ADD_IF_NOT_PRESENT

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Observance(String name)	Constructs a timezone observance with the specified name and no properties.
protected	Observance(String name, PropertyList properties)	Constructor protected to enforce use of sub-classes from this library.

Method Summary

Modifier and Type	Method	Description
final OffsetDateTime	getLatestOnset(Temporal date)	Returns the latest applicable onset of this observance for the specified date.
ValidationResult	validate(boolean recurse)	Perform validation on a component.

Methods inherited from class net.fortuna.ical4j.model.Component

calculateRecurrenceSet, compareTo, copy, equals, getFluentTarget, getName, getProperties, getPropertyList, getUid, getValue, hashCode, newFactory, setPropertyList, toString, validate, validateProperties

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface net.fortuna.ical4j.model.FluentComponent

withProperty

Methods inherited from interface net.fortuna.ical4j.model.PropertyContainer

add, addAll, remove, removeAll, removeIf, replace, setPropertyList, with

Methods inherited from interface net.fortuna.ical4j.model.PropertyListAccessor

getProperties, getProperty, getProperty, getPropertyList, getRequiredProperty, getRequiredProperty

Methods inherited from interface net.fortuna.ical4j.model.TimeZonePropertyAccessor

getLastModified, getStartDate, getTimeZoneId, getTimeZoneOffsetFrom, getTimeZoneOffsetTo, getTimeZoneUrl

Field Details

STANDARD

public static final String STANDARD

one of 'standardc' or 'daylightc' MUST occur and each MAY occur more than once.

See Also:

• Constant Field Values

DAYLIGHT

public static final String DAYLIGHT

Token for daylight observance.

See Also:

• Constant Field Values

Constructor Details

Observance

protected Observance(String name)

Constructs a timezone observance with the specified name and no properties.

Parameters:

name - the name of this observance component

Observance

protected Observance(String name,
 PropertyList properties)

Constructor protected to enforce use of sub-classes from this library.

Parameters:

name - the name of the time type

properties - a list of properties

Method Details

validate

public ValidationResult validate(boolean recurse)
                          throws ValidationException

Perform validation on a component.

Specified by:

validate in class Component

Parameters:

recurse - indicates whether to validate the component's properties

Throws:

ValidationException - where the component is not in a valid state

getLatestOnset

public final OffsetDateTime getLatestOnset(Temporal date)

Returns the latest applicable onset of this observance for the specified date.

Parameters:

date - the latest date that an observance onset may occur

Returns:

the latest applicable observance date or null if there is no applicable observance onset for the specified date