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, FluentComponent, PropertyContainer

Direct Known Subclasses:

Daylight, Standard

public abstract class Observance
extends Component

$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 String	DAYLIGHT	Token for daylight observance.
static 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

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
OffsetDateTime	getLatestOnset(Temporal date)	Returns the latest applicable onset of this observance for the specified date.
Optional<TzOffsetFrom>	getOffsetFrom()	Deprecated. use PropertyContainer.getProperty(String)
Optional<TzOffsetTo>	getOffsetTo()	Deprecated. use PropertyContainer.getProperty(String)
Optional<DtStart<LocalDateTime>>	getStartDate()	Deprecated. use PropertyContainer.getProperty(String)
ValidationResult	validate(boolean recurse)	Perform validation on a component.

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

calculateRecurrenceSet, copy, equals, getFluentTarget, getName, getProperties, getPropertyList, 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, getProperties, getProperty, getRequiredProperty, remove, removeAll, replace

Field Detail

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 Detail

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 Detail

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

getStartDate

@Deprecated
public final Optional<DtStart<LocalDateTime>> getStartDate()

Deprecated.

use PropertyContainer.getProperty(String)

Returns the mandatory dtstart property.

Returns:

the DTSTART property or null if not specified

getOffsetFrom

@Deprecated
public final Optional<TzOffsetFrom> getOffsetFrom()

Deprecated.

use PropertyContainer.getProperty(String)

Returns the mandatory tzoffsetfrom property.

Returns:

the TZOFFSETFROM property or null if not specified

getOffsetTo

@Deprecated
public final Optional<TzOffsetTo> getOffsetTo()

Deprecated.

use PropertyContainer.getProperty(String)

Returns the mandatory tzoffsetto property.

Returns:

the TZOFFSETTO property or null if not specified