KCalCore::Recurrence Class Reference

#include <recurrence.h>

Inherits KCalCore::RecurrenceRule::RuleObserver.

Public Types
enum	{   rNone = 0, rMinutely = 0x001, rHourly = 0x0002, rDaily = 0x0003,   rWeekly = 0x0004, rMonthlyPos = 0x0005, rMonthlyDay = 0x0006, rYearlyMonth = 0x0007,   rYearlyDay = 0x0008, rYearlyPos = 0x0009, rOther = 0x000A, rMax =0x00FF }

Public Member Functions
	Recurrence ()
	Recurrence (const Recurrence &r)
	~Recurrence ()
void	addExDate (const QDate &exdate)
void	addExDateTime (const KDateTime &exdate)
void	addExRule (RecurrenceRule *exrule)
void	addMonthlyDate (short day)
void	addMonthlyPos (short pos, const QBitArray &days)
void	addMonthlyPos (short pos, ushort day)
void	addObserver (RecurrenceObserver *observer)
void	addRDate (const QDate &rdate)
void	addRDateTime (const KDateTime &rdate)
void	addRRule (RecurrenceRule *rrule)
void	addWeeklyDays (const QBitArray &days)
void	addYearlyDate (int date)
void	addYearlyDay (int day)
void	addYearlyMonth (short _rNum)
void	addYearlyPos (short pos, const QBitArray &days)
bool	allDay () const
void	clear ()
QBitArray	days () const
RecurrenceRule *	defaultRRule (bool create=false) const
RecurrenceRule *	defaultRRuleConst () const
void	deleteExRule (RecurrenceRule *exrule)
void	deleteRRule (RecurrenceRule *rrule)
void	dump () const
int	duration () const
int	durationTo (const KDateTime &dt) const
int	durationTo (const QDate &date) const
QDate	endDate () const
KDateTime	endDateTime () const
DateList	exDates () const
DateTimeList	exDateTimes () const
RecurrenceRule::List	exRules () const
int	frequency () const
KDateTime	getNextDateTime (const KDateTime &preDateTime) const
KDateTime	getPreviousDateTime (const KDateTime &afterDateTime) const
QList< int >	monthDays () const
QList< RecurrenceRule::WDayPos >	monthPositions () const
bool	operator!= (const Recurrence &r) const
Recurrence &	operator= (const Recurrence &r)
bool	operator== (const Recurrence &r) const
DateList	rDates () const
DateTimeList	rDateTimes () const
bool	recurReadOnly () const
void	recurrenceChanged (RecurrenceRule *)
ushort	recurrenceType () const
bool	recurs () const
bool	recursAt (const KDateTime &dt) const
bool	recursOn (const QDate &date, const KDateTime::Spec &timeSpec) const
TimeList	recurTimesOn (const QDate &date, const KDateTime::Spec &timeSpec) const
void	removeExRule (RecurrenceRule *exrule)
void	removeObserver (RecurrenceObserver *observer)
void	removeRRule (RecurrenceRule *rrule)
RecurrenceRule::List	rRules () const
void	setAllDay (bool allDay)
void	setDaily (int freq)
void	setDuration (int duration)
void	setEndDate (const QDate &endDate)
void	setEndDateTime (const KDateTime &endDateTime)
void	setExDates (const DateList &exdates)
void	setExDateTimes (const DateTimeList &exdates)
void	setFrequency (int freq)
void	setHourly (int freq)
void	setMinutely (int freq)
void	setMonthly (int freq)
void	setRDates (const DateList &rdates)
void	setRDateTimes (const DateTimeList &rdates)
void	setRecurReadOnly (bool readOnly)
void	setStartDateTime (const KDateTime &start)
void	setWeekly (int freq, int weekStart=1)
void	setWeekly (int freq, const QBitArray &days, int weekStart=1)
void	setYearly (int freq)
void	shiftTimes (const KDateTime::Spec &oldSpec, const KDateTime::Spec &newSpec)
QDate	startDate () const
KDateTime	startDateTime () const
DateTimeList	timesInInterval (const KDateTime &start, const KDateTime &end) const
void	unsetRecurs ()
void	updated ()
int	weekStart () const
QList< int >	yearDates () const
QList< int >	yearDays () const
QList< int >	yearMonths () const
QList< RecurrenceRule::WDayPos >	yearPositions () const

Static Public Member Functions
static ushort	recurrenceType (const RecurrenceRule *rrule)

Static Public Attributes
static const QDate	MAX_DATE

Protected Member Functions
RecurrenceRule *	setNewRecurrenceType (RecurrenceRule::PeriodType type, int freq)

Friends
KCALCORE_EXPORT QDataStream &	operator<< (QDataStream &out, KCalCore::Recurrence *)
KCALCORE_EXPORT QDataStream &	operator>> (QDataStream &in, KCalCore::Recurrence *)

Detailed Description

This class represents a recurrence rule for a calendar incidence.

It manages all recurrence rules, recurrence date/times, exception rules and exception date times that can appear inside calendar items. Each recurrence rule and exception rule is represented as an object of type RecurrenceRule.

For the simple case where at most one recurrence rule is present, this class provides shortcut methods to set the type: setMinutely() setHourly() setDaily() setWeekly() setMonthly() setYearly() to set/get general information about the recurrence: setEndDate() setEndDateTime() duration() durationTo() setDuration() frequency() setFrequency() and to set/get specific information about the recurrence within the interval: days() monthDays() monthPositions() yearDays() yearDates() yearMonths() yearPositions() addMonthlyPos() addMonthlyDate() addYearlyDay() addYearlyDate() addYearlyPos() addYearlyMonth() These are all available so that you don't have to work on the RecurrenceRule objects themselves. In other words, in that simple situation the interface stays almost the same compared to the old Recurrence class, which allowed only one recurrence rule.

As soon as your recurrence consists of multiple recurrence rules or exception rules, you cannot use the methods mentioned above any more (since each rule will have a different type and different settings). If you still call any of them, the set*ly methods will remove all rules and add one rule with the specified type. The add* and the other set* methods will change only the first recurrence rule, but leave the others untouched.

Definition at line 87 of file recurrence.h.

Member Enumeration Documentation

anonymous enum

enumeration for describing how an event recurs, if at all.

Definition at line 99 of file recurrence.h.

Constructor & Destructor Documentation

Recurrence::Recurrence

(

)

Constructs an empty recurrence.

Definition at line 112 of file recurrence.cpp.

Recurrence::Recurrence

(

const Recurrence &

r

)

Copy constructor.

Parameters

r	instance to copy from

Definition at line 117 of file recurrence.cpp.

Recurrence::~Recurrence

(

)

Destructor.

Definition at line 134 of file recurrence.cpp.

Member Function Documentation

void Recurrence::addExRule

(

RecurrenceRule *

exrule

)

Add an exception rule to the recurrence.

Parameters

exrule

the exception rule to add

Definition at line 1210 of file recurrence.cpp.

void Recurrence::addMonthlyDate

(

short

day

)

Adds a date (e.g.

the 15th of each month) to the monthly day recurrence list.

Parameters

day	the date in the month to recur.

Definition at line 807 of file recurrence.cpp.

void Recurrence::addMonthlyPos	(	short	pos,
		const QBitArray &	days
	)

Adds a position (e.g.

first monday) to the monthly recurrence rule.

Parameters

pos	the position in the month for the recurrence, with valid values being 1-5 (5 weeks max in a month).
days	the days for the position to recur on (bit 0 = Monday). Example: pos = 2, and bits 0 and 2 are set in days: the rule is to repeat every 2nd Monday and Wednesday in the month.

Definition at line 757 of file recurrence.cpp.

void Recurrence::addObserver

(

RecurrenceObserver *

observer

)

Installs an observer.

Whenever some setting of this recurrence object is changed, the recurrenceUpdated( Recurrence* ) method of each observer will be called to inform it of changes.

Parameters

observer

the Recurrence::Observer-derived object, which will be installed as an observer of this object.

Definition at line 157 of file recurrence.cpp.

void Recurrence::addRRule

(

RecurrenceRule *

rrule

)

Add a recurrence rule to the recurrence.

Parameters

rrule

the recurrence rule to add

Definition at line 1171 of file recurrence.cpp.

void Recurrence::addWeeklyDays

(

const QBitArray &

days

)

Adds days to the weekly day recurrence list.

Parameters

days	a 7 bit array indicating which days on which to recur (bit 0 = Monday).

Definition at line 745 of file recurrence.cpp.

void Recurrence::addYearlyDate

(

int

date

)

Adds date within a yearly recurrence.

The month(s) for the recurrence can be specified with addYearlyMonth(), otherwise the month of the start date is used.

By default infinite recurrence is used. To set an end date use the method setEndDate and to set the number of occurrences use setDuration.

Parameters

date	the day of the month for the event

Definition at line 850 of file recurrence.cpp.

void Recurrence::addYearlyDay

(

int

day

)

Adds day number of year within a yearly recurrence.

By default infinite recurrence is used. To set an end date use the method setEndDate and to set the number of occurrences use setDuration.

Parameters

day	the day of the year for the event. E.g. if day is 60, this means Feb 29 in leap years and March 1 in non-leap years.

Definition at line 834 of file recurrence.cpp.

void Recurrence::addYearlyMonth

(

short

_rNum

)

Adds month in yearly recurrence.

You can specify specific day numbers within the months (by calling addYearlyDate()) or specific day positions within the month (by calling addYearlyPos).

Parameters

_rNum

the month in which the event shall recur.

Definition at line 862 of file recurrence.cpp.

void Recurrence::addYearlyPos	(	short	pos,
		const QBitArray &	days
	)

Adds position within month/year within a yearly recurrence.

If months are specified (via addYearlyMonth()), the parameters are understood as position within these months, otherwise within the year.

By default infinite recurrence is used. To set an end date use the method setEndDate and to set the number of occurrences use setDuration.

Parameters

pos	the position in the month/year for the recurrence, with valid values being 1 to 53 and -1 to -53 (53 weeks max in a year).
days	the days for the position to recur on (bit 0 = Monday). Example: pos = 2, and bits 0 and 2 are set in days If months are specified (via addYearlyMonth), e.g. March, the rule is to repeat every year on the 2nd Monday and Wednesday of March. If no months are specified, the fule is to repeat every year on the 2nd Monday and Wednesday of the year.

Definition at line 856 of file recurrence.cpp.

bool Recurrence::allDay

(

)

const

Set whether the recurrence has no time, just a date.

All-day means – according to rfc2445 – that the event has no time associated. N.B. This property is derived by default from whether setStartDateTime() is called with a date-only or date/time parameter.

Returns

whether the recurrence has a time (false) or it is just a date (true).

Definition at line 176 of file recurrence.cpp.

void Recurrence::clear

(

)

Removes all recurrence and exception rules and dates.

Definition at line 549 of file recurrence.cpp.

QBitArray Recurrence::days

(

)

const

Returns week day mask (bit 0 = Monday).

Definition at line 629 of file recurrence.cpp.

void Recurrence::deleteExRule

(

RecurrenceRule *

exrule

)

Remove an exception rule from the recurrence and delete it.

Parameters

exrule

the exception rule to remove

Definition at line 1233 of file recurrence.cpp.

void Recurrence::deleteRRule

(

RecurrenceRule *

rrule

)

Remove a recurrence rule from the recurrence and delete it.

Parameters

rrule

the recurrence rule to remove

Definition at line 1194 of file recurrence.cpp.

void Recurrence::dump

(

)

const

Debug output.

Definition at line 1354 of file recurrence.cpp.

int Recurrence::duration

(

)

const

Returns -1 if the event recurs infinitely, 0 if the end date is set, otherwise the total number of recurrences, including the initial occurrence.

Definition at line 481 of file recurrence.cpp.

int Recurrence::durationTo

(

const KDateTime &

dt

)

const

Returns the number of recurrences up to and including the date/time specified.

Warning

This function can be very time consuming - use it sparingly!

Definition at line 487 of file recurrence.cpp.

int Recurrence::durationTo

(

const QDate &

date

)

const

Returns the number of recurrences up to and including the date specified.

Warning

This function can be very time consuming - use it sparingly!

Definition at line 494 of file recurrence.cpp.

QDate Recurrence::endDate

(

)

const

Returns the date of the last recurrence.

Calculates the cumulative end of the whole recurrence (rdates and rrules).

An invalid date is returned if the recurrence has no end.

If any rrule is infinite, or the recurrence doesn't have any rrules or rdates, an invalid date is returned.

Definition at line 453 of file recurrence.cpp.

KDateTime Recurrence::endDateTime

(

)

const

Returns the date/time of the last recurrence.

Calculates the cumulative end of the whole recurrence (rdates and rrules).

An invalid date is returned if the recurrence has no end.

If any rrule is infinite, or the recurrence doesn't have any rrules or rdates, an invalid date is returned.

Definition at line 428 of file recurrence.cpp.

int Recurrence::frequency

(

)

const

Returns frequency of recurrence, in terms of the recurrence time period type.

Definition at line 599 of file recurrence.cpp.

KDateTime Recurrence::getNextDateTime

(

const KDateTime &

preDateTime

)

const

Returns the date and time of the next recurrence, after the specified date/time.

If the recurrence has no time, the next date after the specified date is returned.

Parameters

preDateTime

the date/time after which to find the recurrence.

Returns

date/time of next recurrence (strictly later than the given KDateTime), or invalid date if none.

Definition at line 1018 of file recurrence.cpp.

KDateTime Recurrence::getPreviousDateTime

(

const KDateTime &

afterDateTime

)

const

Returns the date and time of the last previous recurrence, before the specified date/time.

If a time later than 00:00:00 is specified and the recurrence has no time, 00:00:00 on the specified date is returned if that date recurs.

Parameters

afterDateTime

the date/time before which to find the recurrence.

Returns

date/time of previous recurrence (strictly earlier than the given KDateTime), or invalid date if none.

Definition at line 1093 of file recurrence.cpp.

QList< int > Recurrence::monthDays

(

)

const

Returns list of day numbers of a month.

Definition at line 648 of file recurrence.cpp.

QList< RecurrenceRule::WDayPos > Recurrence::monthPositions

(

)

const

Returns list of day positions in months.

Definition at line 659 of file recurrence.cpp.

bool KCalCore::Recurrence::operator!= ( const Recurrence &  r ) const

inline

Comparison operator for inequality.

Parameters

r	instance to compare with

Returns

true if recurrences are the different, false if the same

Definition at line 142 of file recurrence.h.

Recurrence & Recurrence::operator=

(

const Recurrence &

r

)

Assignment operator.

Parameters

r	the recurrence which will be assigned to this.

Definition at line 146 of file recurrence.cpp.

bool Recurrence::operator==

(

const Recurrence &

r

)

const

Comparison operator for equality.

Parameters

r	instance to compare with

Returns

true if recurrences are the same, false otherwise

Definition at line 141 of file recurrence.cpp.

bool Recurrence::recurReadOnly

(

)

const

Returns true if the recurrence is read-only, or false if it can be changed.

Definition at line 571 of file recurrence.cpp.

ushort Recurrence::recurrenceType

(

)

const

Returns the event's recurrence status.

See the enumeration at the top of this file for possible values.

Definition at line 233 of file recurrence.cpp.

ushort Recurrence::recurrenceType ( const RecurrenceRule *  rrule )

static

Returns the recurrence status for a recurrence rule.

See the enumeration at the top of this file for possible values.

Parameters

rrule

the recurrence rule to get the type for

Definition at line 241 of file recurrence.cpp.

bool Recurrence::recurs

(

)

const

Returns whether the event recurs at all.

Definition at line 228 of file recurrence.cpp.

bool Recurrence::recursAt

(

const KDateTime &

dt

)

const

Returns true if the date/time specified is one at which the event will recur.

Times are rounded down to the nearest minute to determine the result.

Parameters

dt	is the date/time to check.

Definition at line 395 of file recurrence.cpp.

bool Recurrence::recursOn	(	const QDate &	date,
		const KDateTime::Spec &	timeSpec
	)		const

Returns true if the date specified is one on which the event will recur.

Parameters

date	date to check.
timeSpec	time specification for date.

Definition at line 330 of file recurrence.cpp.

TimeList Recurrence::recurTimesOn	(	const QDate &	date,
		const KDateTime::Spec &	timeSpec
	)		const

Returns a list of the times on the specified date at which the recurrence will occur.

The returned times should be interpreted in the context of timeSpec.

Parameters

date	the date for which to find the recurrence times
timeSpec	time specification for date

Definition at line 881 of file recurrence.cpp.

void Recurrence::removeExRule

(

RecurrenceRule *

exrule

)

Remove an exception rule from the recurrence.

exrule is not deleted; it is the responsibility of the caller to ensure that it is deleted.

Parameters

exrule

the exception rule to remove

Definition at line 1222 of file recurrence.cpp.

void Recurrence::removeObserver

(

RecurrenceObserver *

observer

)

Removes an observer that was added with addObserver.

If the given object was not an observer, it does nothing.

Parameters

observer

the Recurrence::Observer-derived object to be removed from the list of observers of this object.

Definition at line 164 of file recurrence.cpp.

void Recurrence::removeRRule

(

RecurrenceRule *

rrule

)

Remove a recurrence rule from the recurrence.

rrule is not deleted; it is the responsibility of the caller to ensure that it is deleted.

Parameters

rrule

the recurrence rule to remove

Definition at line 1183 of file recurrence.cpp.

void Recurrence::setAllDay

(

bool

allDay

)

Sets whether the dtstart is a all-day (i.e.

has no time attached)

Parameters

allDay

If the recurrence is for all-day item (true) or has a time associated (false).

Definition at line 181 of file recurrence.cpp.

void Recurrence::setDaily

(

int

freq

)

Sets an event to recur daily.

By default infinite recurrence is used. The minute and second of the recurrence is taken from the start date (if you need to change them, you will have to modify the defaultRRule's byMinute list manually. To set an end date use the method setEndDate and to set the number of occurrences use setDuration.

This method clears all recurrence rules and adds one rule with a daily recurrence. All other recurrence components (recurrence date/times, exception date/times and exception rules) are not modified.

Parameters

freq	the frequency to recur, e.g. 2 is every other day

Definition at line 722 of file recurrence.cpp.

void Recurrence::setDuration

(

int

duration

)

Sets the total number of times the event is to occur, including both the first and last.

Definition at line 499 of file recurrence.cpp.

void Recurrence::setEndDate

(

const QDate &

endDate

)

Sets the date of the last recurrence.

The end time is set to the recurrence start time.

Parameters

endDate

the ending date after which to stop recurring. If the recurrence is not all-day, the end time will be 23:59.

Definition at line 459 of file recurrence.cpp.

void Recurrence::setEndDateTime

(

const KDateTime &

endDateTime

)

Sets the date and time of the last recurrence.

Parameters

endDateTime

the ending date/time after which to stop recurring.

Definition at line 468 of file recurrence.cpp.

void Recurrence::setFrequency

(

int

freq

)

Sets the frequency of recurrence, in terms of the recurrence time period type.

Definition at line 607 of file recurrence.cpp.

void Recurrence::setHourly

(

int

freq

)

Sets an event to recur hourly.

By default infinite recurrence is used. The minute of the recurrence is taken from the start date (if you need to change it, you will have to modify the defaultRRule's byMinute list manually. To set an end date use the method setEndDate and to set the number of occurrences use setDuration.

This method clears all recurrence rules and adds one rule with a hourly recurrence. All other recurrence components (recurrence date/times, exception date/times and exception rules) are not modified.

Parameters

freq	the frequency to recur, e.g. 2 is every other hour

Definition at line 715 of file recurrence.cpp.

void Recurrence::setMinutely

(

int

freq

)

Sets an event to recur minutely.

By default infinite recurrence is used. To set an end date use the method setEndDate and to set the number of occurrences use setDuration.

This method clears all recurrence rules and adds one rule with a minutely recurrence. All other recurrence components (recurrence date/times, exception date/times and exception rules) are not modified.

Parameters

freq	the frequency to recur, e.g. 2 is every other minute

Definition at line 708 of file recurrence.cpp.

void Recurrence::setMonthly

(

int

freq

)

Sets an event to recur monthly.

By default infinite recurrence is used. The date of the monthly recurrence will be taken from the start date unless you explicitly add one or more recurrence dates with addMonthlyDate or a recurrence position in the month (e.g. first monday) using addMonthlyPos. To set an end date use the method setEndDate and to set the number of occurrences use setDuration.

This method clears all recurrence rules and adds one rule with a monthly recurrence. All other recurrence components (recurrence date/times, exception date/times and exception rules) are not modified.

Parameters

freq	the frequency to recur, e.g. 3 for every third month.

Definition at line 750 of file recurrence.cpp.

void Recurrence::setRecurReadOnly

(

bool

readOnly

)

Set if recurrence is read-only or can be changed.

Definition at line 566 of file recurrence.cpp.

void Recurrence::setStartDateTime

(

const KDateTime &

start

)

Set start of recurrence.

If start is date-only, the recurrence is set to all-day. Otherwise, the start is set to a date and time, and the recurrence is set to non-all-day.

Parameters

start

the new start date or date/time of the recurrence.

Definition at line 581 of file recurrence.cpp.

void Recurrence::setWeekly	(	int	freq,
		int	weekStart = 1
	)

Sets an event to recur weekly.

By default infinite recurrence is used. To set an end date use the method setEndDate and to set the number of occurrences use setDuration.

This method clears all recurrence rules and adds one rule with a weekly recurrence. All other recurrence components (recurrence date/times, exception date/times and exception rules) are not modified.

Parameters

freq	the frequency to recur, e.g. every other week etc.
weekStart	the first day of the week (Monday=1 .. Sunday=7, default is Monday).

Definition at line 729 of file recurrence.cpp.

void Recurrence::setWeekly	(	int	freq,
		const QBitArray &	days,
		int	weekStart = 1
	)

Sets an event to recur weekly.

By default infinite recurrence is used. To set an end date use the method setEndDate and to set the number of occurrences use setDuration.

This method clears all recurrence rules and adds one rule with a weekly recurrence. All other recurrence components (recurrence date/times, exception date/times and exception rules) are not modified.

Parameters

freq	the frequency to recur, e.g. every other week etc.
days	a 7 bit array indicating which days on which to recur (bit 0 = Monday).
weekStart	the first day of the week (Monday=1 .. Sunday=7, default is Monday).

Definition at line 739 of file recurrence.cpp.

void Recurrence::setYearly

(

int

freq

)

Sets an event to recur yearly.

By default, this will recur every year on the same date (e.g. every year on April 15 if the start date was April 15). The day of the year can be specified with addYearlyDay(). The day of the month can be specified with addYearlyByDate If both a month and a day ar specified with addYearlyMonth and addYearlyDay, the day is understood as day number within the month.

A position (e.g. 3rd Sunday of year/month, or last Friday of year/month) can be specified with addYearlyPos. Again, if a month is specified, this position is understood as within that month, otherwise within the year.

By default infinite recurrence is used. To set an end date use the method setEndDate and to set the number of occurrences use setDuration.

This method clears all recurrence rules and adds one rule with a yearly recurrence. All other recurrence components (recurrence date/times, exception date/times and exception rules) are not modified.

Parameters

freq	the frequency to recur, e.g. 3 for every third year.

Definition at line 826 of file recurrence.cpp.

void Recurrence::shiftTimes	(	const KDateTime::Spec &	oldSpec,
		const KDateTime::Spec &	newSpec
	)

Shift the times of the recurrence so that they appear at the same clock time as before but in a new time zone.

The shift is done from a viewing time zone rather than from the actual recurrence time zone.

For example, shifting a recurrence whose start time is 09:00 America/New York, using an old viewing time zone (oldSpec) of Europe/London, to a new time zone (newSpec) of Europe/Paris, will result in the time being shifted from 14:00 (which is the London time of the recurrence start) to 14:00 Paris time.

Parameters

oldSpec	the time specification which provides the clock times
newSpec	the new time specification

Definition at line 513 of file recurrence.cpp.

QDate Recurrence::startDate

(

)

const

Return the start date/time of the recurrence.

Definition at line 576 of file recurrence.cpp.

KDateTime Recurrence::startDateTime

(

)

const

Return the start date/time of the recurrence (Time for all-day recurrences will be 0:00).

Returns

the current start/time of the recurrence.

Definition at line 171 of file recurrence.cpp.

DateTimeList Recurrence::timesInInterval	(	const KDateTime &	start,
		const KDateTime &	end
	)		const

Returns a list of all the times at which the recurrence will occur between two specified times.

There is a (large) maximum limit to the number of times returned. If due to this limit the list is incomplete, this is indicated by the last entry being set to an invalid KDateTime value. If you need further values, call the method again with a start time set to just after the last valid time returned.

Parameters

start	inclusive start of interval
end	inclusive end of interval

Returns

list of date/time values

Definition at line 950 of file recurrence.cpp.

void Recurrence::unsetRecurs

(

)

Removes all recurrence rules.

Recurrence dates and exceptions are not removed.

Definition at line 539 of file recurrence.cpp.

int Recurrence::weekStart

(

)

const

Returns the first day of the week.

Uses only the first RRULE if present (i.e. a second RRULE as well as all EXRULES are ignored!

Returns

Weekday of the first day of the week (Monday=1 .. Sunday=7)

Definition at line 622 of file recurrence.cpp.

QList< int > Recurrence::yearDates

(

)

const

Returns the dates within a yearly recurrence.

Returns

the days of the month for the event. E.g. if the list contains 13, this means the recurrence happens on the 13th of the month. The months for the recurrence can be obtained through yearlyMonths(). If this list is empty, the month of the start date is used.

Definition at line 673 of file recurrence.cpp.

QList< int > Recurrence::yearDays

(

)

const

Returns the day numbers within a yearly recurrence.

Returns

the days of the year for the event. E.g. if the list contains 60, this means the recurrence happens on day 60 of the year, i.e. on Feb 29 in leap years and March 1 in non-leap years.

Definition at line 667 of file recurrence.cpp.

QList< int > Recurrence::yearMonths

(

)

const

Returns the months within a yearly recurrence.

Returns

the months for the event. E.g. if the list contains 11, this means the recurrence happens in November. The days for the recurrence can be obtained either through yearDates() if they are given as dates within the month or through yearlyPositions() if they are given as positions within the month. If none is specified, the date of the start date is used.

Definition at line 678 of file recurrence.cpp.

QList< RecurrenceRule::WDayPos > Recurrence::yearPositions

(

)

const

Returns the positions within a yearly recurrence.

Returns

the positions for the event, either within a month (if months are set through addYearlyMonth()) or within the year. E.g. if the list contains {Pos=3, Day=5}, this means the third friday. If a month is set this position is understoodas third Friday in the given months, otherwise as third Friday of the year.Returns list of day positions in months, for a recursYearlyPos recurrence rule.

Definition at line 684 of file recurrence.cpp.

Friends And Related Function Documentation

KCALCORE_EXPORT QDataStream& operator<< ( QDataStream &  out, KCalCore::Recurrence *    )

friend

Recurrence serializer and deserializer.

Since

4.12

Member Data Documentation

const QDate KCalCore::Recurrence::MAX_DATE

static

Upper date limit for recurrences.

Definition at line 551 of file recurrence.h.

---

The documentation for this class was generated from the following files:

• recurrence.h
• recurrence.cpp