org.quartz.impl.calendar

Class BaseCalendar

java.lang.Object

org.quartz.impl.calendar.BaseCalendar

All Implemented Interfaces:

java.io.Serializable, Calendar

Direct Known Subclasses:

AnnualCalendar, CronCalendar, DailyCalendar, HolidayCalendar, MonthlyCalendar, WeeklyCalendar

public class BaseCalendar
extends java.lang.Object
implements Calendar, java.io.Serializable

This implementation of the Calendar may be used (you don't have to) as a base class for more sophisticated one's. It merely implements the base functionality required by each Calendar.

Regarded as base functionality is the treatment of base calendars. Base calendar allow you to chain (stack) as much calendars as you may need. For example to exclude weekends you may use WeeklyCalendar. In order to exclude holidays as well you may define a WeeklyCalendar instance to be the base calendar for HolidayCalendar instance.

Author:

Juergen Donnerstag, James House

See Also:

Calendar, Serialized Form

Field Summary

Fields inherited from interface org.quartz.Calendar

MONTH

Constructor Summary

Constructors

Constructor and Description
BaseCalendar()
BaseCalendar(Calendar baseCalendar)
BaseCalendar(Calendar baseCalendar, java.util.TimeZone timeZone)
BaseCalendar(java.util.TimeZone timeZone)

Method Summary

Methods

Modifier and Type	Method and Description
static java.util.Date	buildHoliday(java.util.Date excludedDate) Deprecated. Always uses the default time zone.
static long	buildHoliday(long timeStamp) Deprecated. Always uses the default time zone.
Calendar	getBaseCalendar() Get the base calendar.
java.lang.String	getDescription() Return the description given to the Calendar instance by its creator (if any).
static java.util.Calendar	getJavaCalendar(long timeStamp) Deprecated. Always uses the default time zone.
long	getNextIncludedTime(long timeStamp) Determine the next time (in milliseconds) that is 'included' by the Calendar after the given time.
java.util.TimeZone	getTimeZone() Returns the time zone for which this Calendar will be resolved.
boolean	isTimeIncluded(long timeStamp) Check if date/time represented by timeStamp is included.
void	setBaseCalendar(Calendar baseCalendar) Set a new base calendar or remove the existing one
void	setDescription(java.lang.String description) Set a description for the Calendar instance - may be useful for remembering/displaying the purpose of the calendar, though the description has no meaning to Quartz.
void	setTimeZone(java.util.TimeZone timeZone) Sets the time zone for which this Calendar will be resolved.

Methods inherited from class java.lang.Object

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

Constructor Detail

BaseCalendar

public BaseCalendar()

BaseCalendar

public BaseCalendar(Calendar baseCalendar)

BaseCalendar

public BaseCalendar(java.util.TimeZone timeZone)

Parameters:

timeZone - The time zone to use for this Calendar, null if TimeZone.getDefault() should be used

BaseCalendar

public BaseCalendar(Calendar baseCalendar,
            java.util.TimeZone timeZone)

Parameters:

timeZone - The time zone to use for this Calendar, null if TimeZone.getDefault() should be used

Method Detail

setBaseCalendar

public void setBaseCalendar(Calendar baseCalendar)

Set a new base calendar or remove the existing one

Specified by:

setBaseCalendar in interface Calendar

getBaseCalendar

public Calendar getBaseCalendar()

Get the base calendar. Will be null, if not set.

Specified by:

getBaseCalendar in interface Calendar

getDescription

public java.lang.String getDescription()

Return the description given to the Calendar instance by its creator (if any).

Specified by:

getDescription in interface Calendar

Returns:

null if no description was set.

setDescription

public void setDescription(java.lang.String description)

Set a description for the Calendar instance - may be useful for remembering/displaying the purpose of the calendar, though the description has no meaning to Quartz.

Specified by:

setDescription in interface Calendar

getTimeZone

public java.util.TimeZone getTimeZone()

Returns the time zone for which this Calendar will be resolved.

Returns:

This Calendar's timezone, null if Calendar should use the TimeZone.getDefault()

setTimeZone

public void setTimeZone(java.util.TimeZone timeZone)

Sets the time zone for which this Calendar will be resolved.

Parameters:

timeZone - The time zone to use for this Calendar, null if TimeZone.getDefault() should be used

isTimeIncluded

public boolean isTimeIncluded(long timeStamp)

Check if date/time represented by timeStamp is included. If included return true. The implementation of BaseCalendar simply calls the base calendars isTimeIncluded() method if base calendar is set.

Specified by:

isTimeIncluded in interface Calendar

See Also:

Calendar.isTimeIncluded(long)

getNextIncludedTime

public long getNextIncludedTime(long timeStamp)

Determine the next time (in milliseconds) that is 'included' by the Calendar after the given time. Return the original value if timeStamp is included. Return 0 if all days are excluded.

Specified by:

getNextIncludedTime in interface Calendar

See Also:

Calendar.getNextIncludedTime(long)

buildHoliday

public static java.util.Date buildHoliday(java.util.Date excludedDate)

Deprecated. Always uses the default time zone.

Utility method. Return the date of excludeDate. The time fraction will be reset to 00.00:00.

buildHoliday

public static long buildHoliday(long timeStamp)

Deprecated. Always uses the default time zone.

Utility method. Return just the date of timeStamp. The time fraction will be reset to 00.00:00.

getJavaCalendar

public static java.util.Calendar getJavaCalendar(long timeStamp)

Deprecated. Always uses the default time zone.

Utility method. Return a java.util.Calendar for timeStamp.