Ical4j - Versionsgeschichte

Jochen: /* Wiederholung in Lücke zwischen Winter- und Sommerzeit */

2016-09-28T20:56:16Z

Wiederholung in Lücke zwischen Winter- und Sommerzeit

← Nächstältere Version		Version vom 28. September 2016, 22:56 Uhr
Zeile 80:		Zeile 80:
	== Wiederholung in Lücke zwischen Winter- und Sommerzeit ==		== Wiederholung in Lücke zwischen Winter- und Sommerzeit ==

	Daily		=== Daily ===

	Trifft die tägliche Wiederholung auf einen nicht existierenden Termin (sprich nicht existierendes Datum bzw. Uhrzeit), wirkt sich dies auf alle Folgetermine aus.		Trifft die tägliche Wiederholung auf einen nicht existierenden Termin (sprich nicht existierendes Datum bzw. Uhrzeit), wirkt sich dies auf alle Folgetermine aus.
	Dies ist bei einer täglichen Wiederholung meist dann gegeben, wenn der zu wiederholende Termin die Lücke des Wechsels von Winter- auf Sommerzeit trifft (z.B. in Deutschland 02:30 Uhr am letzten Sonntag im März). Alle Folgetermine in Sommerzeit fangen bereits eine Stunde früher an (im Beispiel: 01:30 Uhr). Dies passiert, obwohl es sich bei den Zeiten um Floating Date/Times handelt.		Dies ist bei einer täglichen Wiederholung meist dann gegeben, wenn der zu wiederholende Termin die Lücke des Wechsels von Winter- auf Sommerzeit trifft (z.B. in Deutschland 02:30 Uhr am letzten Sonntag im März). Alle Folgetermine in Sommerzeit fangen bereits eine Stunde früher an (im Beispiel: 01:30 Uhr). Dies passiert, obwohl es sich bei den Zeiten um Floating Date/Times handelt.

	Beispiel – Floating Date/Times:		Beispiel – Floating Date/Times:
			<syntaxhighlight lang="text">
	28.03.2014 02:30		28.03.2014 02:30
	29.03.2014 02:30		29.03.2014 02:30
Zeile 89:		Zeile 92:
	31.03.2014 01:30		31.03.2014 01:30
	32.03.2014 01:30		32.03.2014 01:30
	Weekly		</syntaxhighlight>


			=== Weekly ===

	Trifft die wöchentliche Wiederholung auf einen nicht existierenden Termin (sprich nicht existierendes Datum bzw. Uhrzeit), wirkt sich dies auf alle Folgetermine aus.		Trifft die wöchentliche Wiederholung auf einen nicht existierenden Termin (sprich nicht existierendes Datum bzw. Uhrzeit), wirkt sich dies auf alle Folgetermine aus.
	Dies ist bei einer wöchentlichen Wiederholung meist dann gegeben, wenn der zu wiederholende Termin die Lücke des Wechsels von Winter- auf Sommerzeit trifft (z.B. in Deutschland 02:30 Uhr am letzten Sonntag im März). Alle Folgetermine in Sommerzeit fangen bereits eine Stunde früher an (im Beispiel: 01:30 Uhr). Dies passiert, obwohl es sich bei den Zeiten um Floating Date/Times handelt.		Dies ist bei einer wöchentlichen Wiederholung meist dann gegeben, wenn der zu wiederholende Termin die Lücke des Wechsels von Winter- auf Sommerzeit trifft (z.B. in Deutschland 02:30 Uhr am letzten Sonntag im März). Alle Folgetermine in Sommerzeit fangen bereits eine Stunde früher an (im Beispiel: 01:30 Uhr). Dies passiert, obwohl es sich bei den Zeiten um Floating Date/Times handelt.

	Beispiel – Floating Date/Times:		Beispiel – Floating Date/Times:

			<syntaxhighlight lang="text">
	16.03.2014 02:30		16.03.2014 02:30
	23.03.2014 02:30		23.03.2014 02:30
Zeile 98:		Zeile 108:
	06.04.2014 01:30		06.04.2014 01:30
	13.04.2014 01:30		13.04.2014 01:30
	Monthly		</syntaxhighlight>


			=== Monthly ===

	Trifft die monatliche Wiederholung auf einen nicht existierenden Termin (sprich nicht existierendes Datum bzw. Uhrzeit), wirkt sich dies auf alle Folgetermine aus.		Trifft die monatliche Wiederholung auf einen nicht existierenden Termin (sprich nicht existierendes Datum bzw. Uhrzeit), wirkt sich dies auf alle Folgetermine aus.
	Dies ist bei einer monatlichen Wiederholung meist dann gegeben, wenn der zu wiederholende Termin die Lücke des Wechsels von Winter- auf Sommerzeit trifft (z.B. in Deutschland 02:30 Uhr am letzten Sonntag im März). Alle Folgetermine in Sommerzeit fangen erst eine Stunde später an (im Beispiel: 03:30 Uhr). Dies passiert, obwohl es sich bei den Zeiten um Floating Date/Times handelt.		Dies ist bei einer monatlichen Wiederholung meist dann gegeben, wenn der zu wiederholende Termin die Lücke des Wechsels von Winter- auf Sommerzeit trifft (z.B. in Deutschland 02:30 Uhr am letzten Sonntag im März). Alle Folgetermine in Sommerzeit fangen erst eine Stunde später an (im Beispiel: 03:30 Uhr). Dies passiert, obwohl es sich bei den Zeiten um Floating Date/Times handelt.

	Beispiel – Floating Date/Times - alle zwei Monate:		Beispiel – Floating Date/Times - alle zwei Monate:

			<syntaxhighlight lang="text">
	30.01.2014 02:30		30.01.2014 02:30
	30.03.2014 03:30		30.03.2014 03:30
	30.05.2014 03:30		30.05.2014 03:30
	30.07.2014 03:30		30.07.2014 03:30
			</syntaxhighlight>

Jochen: /* Jährliche Wiederholung am 29. Februar */

2016-09-28T20:54:03Z

Jährliche Wiederholung am 29. Februar

← Nächstältere Version		Version vom 28. September 2016, 22:54 Uhr
Zeile 63:		Zeile 63:


	Dieser Umstand ist in der ical4j Klasse net.fortuna.ical4j.model.Recur begründet. Diese enthält die Methode increment(). Diese addiert das jeweils spezifizierte Wiederholungsintervall. D.h. in diesem Fall ein Jahr. Die Java Calendar Klasse liefert den 28.02. des Folgejahr, wenn zum 29.02. ein Jah addiert wird. Ab diesem Punkt wird zum 28.02. jeweils ein Jahr hinzuaddiert. Daher verbleibt die Wiederholung auf dem 28.02.		Dieser Umstand ist in der ical4j Klasse <code>net.fortuna.ical4j.model.Recur</code> begründet. Diese enthält die Methode <code>increment()</code>. Diese addiert das jeweils spezifizierte Wiederholungsintervall. D.h. in diesem Fall ein Jahr. Die Java Calendar Klasse liefert den 28.02. des Folgejahr, wenn zum 29.02. ein Jah addiert wird. Ab diesem Punkt wird zum 28.02. jeweils ein Jahr hinzuaddiert. Daher verbleibt die Wiederholung auf dem 28.02.
	/**
	* Increments the specified calendar according to the frequency and interval specified in this recurrence rule.		<syntaxhighlight lang="java">
	* @param cal a java.util.Calendar to increment		/**
	*/		* Increments the specified calendar according to the frequency and interval specified in this recurrence rule.
	private void increment(final Calendar cal) {		* @param cal a java.util.Calendar to increment
	// initialise interval..		*/
	final int calInterval = (getInterval() >= 1) ? getInterval() : 1;		private void increment(final Calendar cal) {
	cal.add(calIncField, calInterval);		// initialise interval..
	}		final int calInterval = (getInterval() >= 1) ? getInterval() : 1;
	Wiederholung in Lücke zwischen Winter- und Sommerzeit		cal.add(calIncField, calInterval);
			}
			</syntaxhighlight>


			== Wiederholung in Lücke zwischen Winter- und Sommerzeit ==

	Daily		Daily
	Trifft die tägliche Wiederholung auf einen nicht existierenden Termin (sprich nicht existierendes Datum bzw. Uhrzeit), wirkt sich dies auf alle Folgetermine aus.		Trifft die tägliche Wiederholung auf einen nicht existierenden Termin (sprich nicht existierendes Datum bzw. Uhrzeit), wirkt sich dies auf alle Folgetermine aus.

Jochen am 28. September 2016 um 20:50 Uhr

2016-09-28T20:50:24Z

← Nächstältere Version		Version vom 28. September 2016, 22:50 Uhr
Zeile 14:		Zeile 14:

	<syntaxhighlight lang="java">		<syntaxhighlight lang="java">
	/**		/**
	* Applies BYMONTHDAY rules specified in this Recur instance to the specified date list. If no		* Applies BYMONTHDAY rules specified in this Recur instance to the specified date list. If no
	* BYMONTHDAY rules are		* BYMONTHDAY rules are
	* specified the date list is returned unmodified.		* specified the date list is returned unmodified.
	* @param dates		* @param dates
	* @return		* @return
	*/		*/
	private DateList getMonthDayVariants(final DateList dates) {		private DateList getMonthDayVariants(final DateList dates) {
	if (getMonthDayList().isEmpty()) {		if (getMonthDayList().isEmpty()) {
	return dates;		return dates;
	}		}
	final DateList monthDayDates = getDateListInstance(dates);		final DateList monthDayDates = getDateListInstance(dates);
	for (final Iterator i = dates.iterator(); i.hasNext();) {		for (final Iterator i = dates.iterator(); i.hasNext();) {
	final Date date = (Date) i.next();		final Date date = (Date) i.next();
	final Calendar cal = getCalendarInstance(date, false);		final Calendar cal = getCalendarInstance(date, false);
	for (final Iterator j = getMonthDayList().iterator(); j.hasNext();) {		for (final Iterator j = getMonthDayList().iterator(); j.hasNext();) {
	final Integer monthDay = (Integer) j.next();		final Integer monthDay = (Integer) j.next();
	try {		try {
	cal.set(Calendar.DAY_OF_MONTH, Dates.getAbsMonthDay(cal.getTime(), monthDay.intValue()));		cal.set(Calendar.DAY_OF_MONTH, Dates.getAbsMonthDay(cal.getTime(), monthDay.intValue()));
	monthDayDates.add(Dates.getInstance(cal.getTime(), monthDayDates.getType()));		monthDayDates.add(Dates.getInstance(cal.getTime(), monthDayDates.getType()));
	}		}
	catch (IllegalArgumentException iae) {		catch (IllegalArgumentException iae) {
	if (log.isTraceEnabled()) {		if (log.isTraceEnabled()) {
	log.trace("Invalid day of month: " + Dates.getAbsMonthDay(cal		log.trace("Invalid day of month: " + Dates.getAbsMonthDay(cal
	.getTime(), monthDay.intValue()));		.getTime(), monthDay.intValue()));
	}
	}		}
	}		}
	}		}
	~~return monthDayDates;~~
	}		}
			return monthDayDates;
			}
	</syntaxhighlight>		</syntaxhighlight>


	Jährliche Wiederholung am 29. Februar		== Jährliche Wiederholung am 29. Februar ==

	Eine jährliche Wiederholung am 29. Februar liefert ein unvorhergesehenes Ergebnis. Das Ergebnisset enthält den als Startdatum spezifizierten 29. Februar. Danach ist ausschließlich der 28. Februar aller Folgejahre enthalten.		Eine jährliche Wiederholung am 29. Februar liefert ein unvorhergesehenes Ergebnis. Das Ergebnisset enthält den als Startdatum spezifizierten 29. Februar. Danach ist ausschließlich der 28. Februar aller Folgejahre enthalten.

	Beispiel:		Beispiel:
			<syntaxhighlight lang="text">
	29.02.2016 00:00:00 (Schaltjahr)		29.02.2016 00:00:00 (Schaltjahr)
	28.02.2017 00:00:00		28.02.2017 00:00:00
Zeile 57:		Zeile 60:
	28.02.2020 00:00:00 (Schaltjahr)		28.02.2020 00:00:00 (Schaltjahr)
	28.02.2021 00:00:00		28.02.2021 00:00:00
			</syntaxhighlight>


	Dieser Umstand ist in der ical4j Klasse net.fortuna.ical4j.model.Recur begründet. Diese enthält die Methode increment(). Diese addiert das jeweils spezifizierte Wiederholungsintervall. D.h. in diesem Fall ein Jahr. Die Java Calendar Klasse liefert den 28.02. des Folgejahr, wenn zum 29.02. ein Jah addiert wird. Ab diesem Punkt wird zum 28.02. jeweils ein Jahr hinzuaddiert. Daher verbleibt die Wiederholung auf dem 28.02.		Dieser Umstand ist in der ical4j Klasse net.fortuna.ical4j.model.Recur begründet. Diese enthält die Methode increment(). Diese addiert das jeweils spezifizierte Wiederholungsintervall. D.h. in diesem Fall ein Jahr. Die Java Calendar Klasse liefert den 28.02. des Folgejahr, wenn zum 29.02. ein Jah addiert wird. Ab diesem Punkt wird zum 28.02. jeweils ein Jahr hinzuaddiert. Daher verbleibt die Wiederholung auf dem 28.02.
	/**		/**

Jochen: Die Seite wurde neu angelegt: „TOC == Exception bei monatlicher Wiederholung == Bei einer monatlichen Wiederholung kann es unter folgenden Vorausetzungen zu Exceptions kommen: Monatl…“

2016-09-28T20:46:47Z

Die Seite wurde neu angelegt: „__TOC__ == Exception bei monatlicher Wiederholung == Bei einer monatlichen Wiederholung kann es unter folgenden Vorausetzungen zu Exceptions kommen: Monatl…“

Neue Seite

__TOC__

== Exception bei monatlicher Wiederholung ==

Bei einer monatlichen Wiederholung kann es unter folgenden Vorausetzungen zu Exceptions kommen:

Monatliche Wiederholung an einem Tag des Monats, welcher nicht in allen zu wiederholenden Monaten existiert (z.B. 29., 30 oder 31 eines Monats). Die Exception wird durch einen Log-Eintrag ausgelöst und wird nur dann geworfen, wenn das Loglevel (log4j Adapter) auf TRACE oder ALL steht. Ab DEBUG oder höher existiert das Problem nicht.

In Version 1.0.5.2 stellt sich dieses Problem wie folgt dar:

Die Klasse <code>net.fortuna.ical4j.model.Recur</code> enthält die Methode <code>getMonthDayVariants()</code>. Diese ermittelt die sich monatlich wiederholenden Termine. Nehmen wir eine monatliche Wiederholung am 30. des Monats an. Im Monat Februar versucht der Java <code>Calendar</code> via <code>cal.set(Calendar.DAY_OF_MONTH...)</code> den 30.02. zu setzen. Dies gelingt nicht und eine Exception wird geworfen. Zusätzlich vermerkt sich die <code>Calendar</code> Instanz intern, dass ein ungültiges Datum gespeichert ist. Durch das Werfen der Exception wird der catch-Handler aufgerufen. Ist das Loglevel TRACE oder ALL konfiguriert, versucht ical4j diesen Umstand im Log zu dokumentieren. Hierbei wird jedoch <code>cal.getTime()</code> aufgerufen. Da sich die jeweiligen Calendar Instanz merkte, dass sie ein ungültiges Datum speichert, wirft dieser Aufruf erneut eine Exception. Diese hat nun keinen catch-Handler und fliegt bis zum Aufrufer durch.

<syntaxhighlight lang="java">
/**
* Applies BYMONTHDAY rules specified in this Recur instance to the specified date list. If no
* BYMONTHDAY rules are
* specified the date list is returned unmodified.
* @param dates
* @return
*/
private DateList getMonthDayVariants(final DateList dates) {
if (getMonthDayList().isEmpty()) {
return dates;
}
final DateList monthDayDates = getDateListInstance(dates);
for (final Iterator i = dates.iterator(); i.hasNext();) {
final Date date = (Date) i.next();
final Calendar cal = getCalendarInstance(date, false);
for (final Iterator j = getMonthDayList().iterator(); j.hasNext();) {
final Integer monthDay = (Integer) j.next();
try {
cal.set(Calendar.DAY_OF_MONTH, Dates.getAbsMonthDay(cal.getTime(), monthDay.intValue()));
monthDayDates.add(Dates.getInstance(cal.getTime(), monthDayDates.getType()));
}
catch (IllegalArgumentException iae) {
if (log.isTraceEnabled()) {
log.trace("Invalid day of month: " + Dates.getAbsMonthDay(cal
.getTime(), monthDay.intValue()));
}
}
}
}
return monthDayDates;
}
</syntaxhighlight>

Jährliche Wiederholung am 29. Februar
Eine jährliche Wiederholung am 29. Februar liefert ein unvorhergesehenes Ergebnis. Das Ergebnisset enthält den als Startdatum spezifizierten 29. Februar. Danach ist ausschließlich der 28. Februar aller Folgejahre enthalten.
Beispiel:
29.02.2016 00:00:00 (Schaltjahr)
28.02.2017 00:00:00
28.02.2018 00:00:00
28.02.2019 00:00:00
28.02.2020 00:00:00 (Schaltjahr)
28.02.2021 00:00:00
Dieser Umstand ist in der ical4j Klasse net.fortuna.ical4j.model.Recur begründet. Diese enthält die Methode increment(). Diese addiert das jeweils spezifizierte Wiederholungsintervall. D.h. in diesem Fall ein Jahr. Die Java Calendar Klasse liefert den 28.02. des Folgejahr, wenn zum 29.02. ein Jah addiert wird. Ab diesem Punkt wird zum 28.02. jeweils ein Jahr hinzuaddiert. Daher verbleibt die Wiederholung auf dem 28.02.
/**
* Increments the specified calendar according to the frequency and interval specified in this recurrence rule.
* @param cal a java.util.Calendar to increment
*/
private void increment(final Calendar cal) {
// initialise interval..
final int calInterval = (getInterval() >= 1) ? getInterval() : 1;
cal.add(calIncField, calInterval);
}
Wiederholung in Lücke zwischen Winter- und Sommerzeit
Daily
Trifft die tägliche Wiederholung auf einen nicht existierenden Termin (sprich nicht existierendes Datum bzw. Uhrzeit), wirkt sich dies auf alle Folgetermine aus.
Dies ist bei einer täglichen Wiederholung meist dann gegeben, wenn der zu wiederholende Termin die Lücke des Wechsels von Winter- auf Sommerzeit trifft (z.B. in Deutschland 02:30 Uhr am letzten Sonntag im März). Alle Folgetermine in Sommerzeit fangen bereits eine Stunde früher an (im Beispiel: 01:30 Uhr). Dies passiert, obwohl es sich bei den Zeiten um Floating Date/Times handelt.
Beispiel – Floating Date/Times:
28.03.2014 02:30
29.03.2014 02:30
30.03.2014 01:30
31.03.2014 01:30
32.03.2014 01:30
Weekly
Trifft die wöchentliche Wiederholung auf einen nicht existierenden Termin (sprich nicht existierendes Datum bzw. Uhrzeit), wirkt sich dies auf alle Folgetermine aus.
Dies ist bei einer wöchentlichen Wiederholung meist dann gegeben, wenn der zu wiederholende Termin die Lücke des Wechsels von Winter- auf Sommerzeit trifft (z.B. in Deutschland 02:30 Uhr am letzten Sonntag im März). Alle Folgetermine in Sommerzeit fangen bereits eine Stunde früher an (im Beispiel: 01:30 Uhr). Dies passiert, obwohl es sich bei den Zeiten um Floating Date/Times handelt.
Beispiel – Floating Date/Times:
16.03.2014 02:30
23.03.2014 02:30
30.03.2014 01:30
06.04.2014 01:30
13.04.2014 01:30
Monthly
Trifft die monatliche Wiederholung auf einen nicht existierenden Termin (sprich nicht existierendes Datum bzw. Uhrzeit), wirkt sich dies auf alle Folgetermine aus.
Dies ist bei einer monatlichen Wiederholung meist dann gegeben, wenn der zu wiederholende Termin die Lücke des Wechsels von Winter- auf Sommerzeit trifft (z.B. in Deutschland 02:30 Uhr am letzten Sonntag im März). Alle Folgetermine in Sommerzeit fangen erst eine Stunde später an (im Beispiel: 03:30 Uhr). Dies passiert, obwohl es sich bei den Zeiten um Floating Date/Times handelt.
Beispiel – Floating Date/Times - alle zwei Monate:
30.01.2014 02:30
30.03.2014 03:30
30.05.2014 03:30
30.07.2014 03:30

Ical4j - Versionsgeschichte

Jochen: /* Wiederholung in Lücke zwischen Winter- und Sommerzeit */

Jochen: /* Jährliche Wiederholung am 29. Februar */

Jochen am 28. September 2016 um 20:50 Uhr

Jochen: Die Seite wurde neu angelegt: „__TOC__ == Exception bei monatlicher Wiederholung == Bei einer monatlichen Wiederholung kann es unter folgenden Vorausetzungen zu Exceptions kommen: Monatl…“

Jochen: Die Seite wurde neu angelegt: „TOC == Exception bei monatlicher Wiederholung == Bei einer monatlichen Wiederholung kann es unter folgenden Vorausetzungen zu Exceptions kommen: Monatl…“