Stellt eine Wiederholungsregel für eine Terminreihe dar.
Beachten Sie, dass sich diese Klasse auch wie die EventRecurrence
verhält, zu der sie gehört, sodass Sie die Erstellung von Regeln so verketten können:
recurrence.addDailyRule().times(3).interval(2).addWeeklyExclusion().times(2);Modifikatoren wie
times(times)
und interval(interval)
werden auf die zuletzt hinzugefügte Regel angewendet.Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
addDailyExclusion() | RecurrenceRule | Fügt eine Regel hinzu, die Termine täglich ausschließt. |
addDailyRule() | RecurrenceRule | Fügt eine Regel hinzu, die dafür sorgt, dass sich der Termin täglich wiederholt. |
addDate(date) | EventRecurrence | Fügt eine Regel hinzu, die dafür sorgt, dass sich der Termin an einem bestimmten Datum wiederholt. |
addDateExclusion(date) | EventRecurrence | Fügt eine Regel hinzu, die ein Vorkommen für ein bestimmtes Datum ausschließt. |
addMonthlyExclusion() | RecurrenceRule | Fügt eine Regel hinzu, die Vorkommen auf monatlicher Basis ausschließt. |
addMonthlyRule() | RecurrenceRule | Fügt eine Regel hinzu, die dafür sorgt, dass sich der Termin monatlich wiederholt. |
addWeeklyExclusion() | RecurrenceRule | Fügt eine Regel hinzu, die Vorkommen wöchentlich ausschließt. |
addWeeklyRule() | RecurrenceRule | Fügt eine Regel hinzu, die dafür sorgt, dass sich der Termin wöchentlich wiederholt. |
addYearlyExclusion() | RecurrenceRule | Fügt eine Regel hinzu, die Termine jährlich ausschließt. |
addYearlyRule() | RecurrenceRule | Fügt eine Regel hinzu, die dafür sorgt, dass sich der Termin jährlich wiederholt. |
interval(interval) | RecurrenceRule | Konfiguriert die Regel so, dass sie nur in diesem Intervall der Zeiteinheit der Regel angewendet wird. |
onlyInMonth(month) | RecurrenceRule | Konfiguriert die Regel so, dass sie nur auf einen bestimmten Monat angewendet wird. |
onlyInMonths(months) | RecurrenceRule | Konfiguriert die Regel so, dass sie nur für bestimmte Monate gilt. |
onlyOnMonthDay(day) | RecurrenceRule | Konfiguriert die Regel so, dass sie nur auf einen bestimmten Tag des Monats angewendet wird. |
onlyOnMonthDays(days) | RecurrenceRule | Konfiguriert die Regel so, dass sie nur auf bestimmte Tage des Monats angewendet wird. |
onlyOnWeek(week) | RecurrenceRule | Konfiguriert die Regel so, dass sie nur auf eine bestimmte Woche des Jahres angewendet wird. |
onlyOnWeekday(day) | RecurrenceRule | Konfiguriert die Regel so, dass sie nur für einen bestimmten Wochentag gilt. |
onlyOnWeekdays(days) | RecurrenceRule | Konfiguriert die Regel so, dass sie nur auf bestimmte Wochentage angewendet wird. |
onlyOnWeeks(weeks) | RecurrenceRule | Konfiguriert die Regel so, dass sie nur für bestimmte Wochen des Jahres gilt. |
onlyOnYearDay(day) | RecurrenceRule | Konfiguriert die Regel so, dass sie nur für einen bestimmten Tag des Jahres gilt. |
onlyOnYearDays(days) | RecurrenceRule | Konfiguriert die Regel so, dass sie nur für bestimmte Tage des Jahres gilt. |
setTimeZone(timeZone) | EventRecurrence | Legt die Zeitzone für diese Serie fest. |
times(times) | RecurrenceRule | Konfiguriert die Regel so, dass sie nach einer bestimmten Anzahl von Wiederholungen endet. |
until(endDate) | RecurrenceRule | Konfiguriert die Regel so, dass sie an einem bestimmten Datum endet (einschließlich). |
weekStartsOn(day) | RecurrenceRule | Konfiguriert, an welchem Tag eine Woche beginnt, um die Regel anzuwenden. |
Detaillierte Dokumentation
addDailyExclusion()
Fügt eine Regel hinzu, die Termine täglich ausschließt.
// Creates a rule that recurs every week after the first 30 days. var recurrence = CalendarApp.newRecurrence().addWeeklyRule().addDailyExclusion().times(30);
Return
RecurrenceRule
– die neue RecurrenceRule
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addDailyRule()
Fügt eine Regel hinzu, die dafür sorgt, dass sich der Termin täglich wiederholt.
// Creates a rule that recurs every day for ten days. var recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);
Return
RecurrenceRule
– die neue RecurrenceRule
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addDate(date)
Fügt eine Regel hinzu, die dafür sorgt, dass sich der Termin an einem bestimmten Datum wiederholt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
date | Date |
Return
EventRecurrence
– diese EventRecurrence für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addDateExclusion(date)
Fügt eine Regel hinzu, die ein Vorkommen für ein bestimmtes Datum ausschließt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
date | Date |
Return
EventRecurrence
– diese EventRecurrence für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addMonthlyExclusion()
Fügt eine Regel hinzu, die Vorkommen auf monatlicher Basis ausschließt.
Standardmäßig wird der Ausschluss am selben Tag des Monats wie das erste Ereignis der Serie angewendet. Dies kann jedoch durch Aufrufen von onlyOnMonthDay(day)
oder onlyOnMonthDays(days)
geändert werden.
Return
RecurrenceRule
– die neue RecurrenceRule
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addMonthlyRule()
Fügt eine Regel hinzu, die dafür sorgt, dass sich der Termin monatlich wiederholt.
Standardmäßig wird der Termin am selben Tag des Monats wiederholt wie der erste Termin in der Serie. Dies kann aber durch Aufrufen von onlyOnMonthDay(day)
oder onlyOnMonthDays(days)
geändert werden.
// Creates a rule that recurs every month for three months. var recurrence = CalendarApp.newRecurrence().addMonthlyRule().times(4);
Return
RecurrenceRule
– die neue RecurrenceRule
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addWeeklyExclusion()
Fügt eine Regel hinzu, die Vorkommen wöchentlich ausschließt.
Standardmäßig wird der Ausschluss am selben Wochentag wie der erste Termin der Serie angewendet. Dies kann jedoch durch Aufrufen von onlyOnWeekday(day)
oder onlyOnWeekdays(days)
geändert werden.
// Creates a rule that recurs every day except the first four Wednesdays. var recurrence = CalendarApp.newRecurrence().addDailyRule() .addWeeklyExclusion().onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY).times(4);
Return
RecurrenceRule
– die neue RecurrenceRule
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addWeeklyRule()
Fügt eine Regel hinzu, die dafür sorgt, dass sich der Termin wöchentlich wiederholt.
Standardmäßig wird der Termin am selben Wochentag wie der erste Termin in der Serie wiederholt. Dies kann aber durch Aufrufen von onlyOnWeekday(day)
oder onlyOnWeekdays(days)
geändert werden.
// Creates a rule that recurs every week for ten weeks. var recurrence = CalendarApp.newRecurrence().addWeeklyRule().times(10);
Return
RecurrenceRule
– die neue RecurrenceRule
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addYearlyExclusion()
Fügt eine Regel hinzu, die Termine jährlich ausschließt.
Standardmäßig wird der Ausschluss am selben Tag des Jahres wie das erste Ereignis der Serie angewendet. Dies kann jedoch durch Aufrufen von onlyOnYearDay(day)
oder onlyOnYearDays(days)
geändert werden.
Return
RecurrenceRule
– die neue RecurrenceRule
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addYearlyRule()
Fügt eine Regel hinzu, die dafür sorgt, dass sich der Termin jährlich wiederholt.
Standardmäßig wird der Termin am selben Tag des Jahres wiederholt wie der erste Termin in der Serie. Dies kann aber durch Aufrufen von onlyOnYearDay(day)
oder onlyOnYearDays(days)
geändert werden.
Return
RecurrenceRule
– die neue RecurrenceRule
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
interval(interval)
Konfiguriert die Regel so, dass sie nur in diesem Intervall der Zeiteinheit der Regel angewendet wird.
// Creates a rule that recurs every fourth week. var recurrence = CalendarApp.newRecurrence().addWeeklyRule().interval(4);
Parameter
Name | Typ | Beschreibung |
---|---|---|
interval | Integer | das Intervall in der Zeiteinheit der Regel |
Return
RecurrenceRule
– diese RecurrenceRule für Verkettungen
onlyInMonth(month)
Konfiguriert die Regel so, dass sie nur auf einen bestimmten Monat angewendet wird.
// Creates a rule that recurs every week in February. var recurrence = CalendarApp.newRecurrence() .addWeeklyRule().onlyInMonth(CalendarApp.Month.FEBRUARY);
Parameter
Name | Typ | Beschreibung |
---|---|---|
month | Month | der Monat |
Return
RecurrenceRule
– diese RecurrenceRule für Verkettungen
onlyInMonths(months)
Konfiguriert die Regel so, dass sie nur für bestimmte Monate gilt.
// Creates a rule that recurs every week in February and March. var recurrence = CalendarApp.newRecurrence() .addWeeklyRule().onlyInMonths([CalendarApp.Month.FEBRUARY, CalendarApp.Month.MARCH]);
Parameter
Name | Typ | Beschreibung |
---|---|---|
months | Month[] | die Monate |
Return
RecurrenceRule
– diese RecurrenceRule für Verkettungen
onlyOnMonthDay(day)
Konfiguriert die Regel so, dass sie nur auf einen bestimmten Tag des Monats angewendet wird.
// Creates a rule that recurs every month on the fifth day of the month. var recurrence = CalendarApp.newRecurrence().addMonthlyRule().onlyOnMonthDay(5);
Parameter
Name | Typ | Beschreibung |
---|---|---|
day | Integer | der Tag des Monats |
Return
RecurrenceRule
– diese RecurrenceRule für Verkettungen
onlyOnMonthDays(days)
Konfiguriert die Regel so, dass sie nur auf bestimmte Tage des Monats angewendet wird.
// Creates a rule that recurs every month on the first and fifteenth day of the month. var recurrence = CalendarApp.newRecurrence().addMonthlyRule().onlyOnMonthDays([1, 15]);
Parameter
Name | Typ | Beschreibung |
---|---|---|
days | Integer[] | den Tagen des Monats |
Return
RecurrenceRule
– diese RecurrenceRule für Verkettungen
onlyOnWeek(week)
Konfiguriert die Regel so, dass sie nur auf eine bestimmte Woche des Jahres angewendet wird.
// Creates a rule that recurs on the fifth week of every year. var recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeek(5);
Parameter
Name | Typ | Beschreibung |
---|---|---|
week | Integer | die Woche |
Return
RecurrenceRule
– diese RecurrenceRule für Verkettungen
onlyOnWeekday(day)
Konfiguriert die Regel so, dass sie nur für einen bestimmten Wochentag gilt.
// Creates a rule that recurs every week on Wednesdays. var recurrence = CalendarApp.newRecurrence() .addWeeklyRule().onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY);
Parameter
Name | Typ | Beschreibung |
---|---|---|
day | Weekday | der Wochentag |
Return
RecurrenceRule
– diese RecurrenceRule für Verkettungen
onlyOnWeekdays(days)
Konfiguriert die Regel so, dass sie nur auf bestimmte Wochentage angewendet wird.
// Creates a rule that recurs every week on Tuesdays and Thursdays. var recurrence = CalendarApp.newRecurrence() .addWeeklyRule().onlyOnWeekdays( [CalendarApp.Weekday.TUESDAY, CalendarApp.Weekday.THURSDAY]);
Parameter
Name | Typ | Beschreibung |
---|---|---|
days | Weekday[] | die Wochentage |
Return
RecurrenceRule
– diese RecurrenceRule für Verkettungen
onlyOnWeeks(weeks)
Konfiguriert die Regel so, dass sie nur für bestimmte Wochen des Jahres gilt.
// Creates a rule that recurs on the fifth and tenth weeks of every year. var recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeeks([5, 10]);
Parameter
Name | Typ | Beschreibung |
---|---|---|
weeks | Integer[] | die Wochen |
Return
RecurrenceRule
– diese RecurrenceRule für Verkettungen
onlyOnYearDay(day)
Konfiguriert die Regel so, dass sie nur für einen bestimmten Tag des Jahres gilt.
// Creates a rule that recurs every year on February 15 (the 46th day). var recurrence = CalendarApp.newRecurrence().addYearlyRule().onlyOnYearDay(46);
Parameter
Name | Typ | Beschreibung |
---|---|---|
day | Integer | der Tag des Jahres |
Return
RecurrenceRule
– diese RecurrenceRule für Verkettungen
onlyOnYearDays(days)
Konfiguriert die Regel so, dass sie nur für bestimmte Tage des Jahres gilt.
// Creates a rule that recurs every year on January 20 and February 15. var recurrence = CalendarApp.newRecurrence().addYearlyRule().onlyOnYearDay([20, 46]);
Parameter
Name | Typ | Beschreibung |
---|---|---|
days | Integer[] | die Tage des Jahres |
Return
RecurrenceRule
– diese RecurrenceRule für Verkettungen
setTimeZone(timeZone)
Legt die Zeitzone für diese Serie fest. Dies wirkt sich auf das Datum und die Uhrzeit aus, an dem bzw. die Termine wiederholt werden, und darauf, ob sich der Termin an die Sommerzeit verschiebt. Die Standardeinstellung ist die Zeitzone des Kalenders.
Parameter
Name | Typ | Beschreibung |
---|---|---|
timeZone | String | die im „long“-Format angegebene Zeitzone (z.B. 'America/New_York', wie von Joda.org aufgeführt) |
Return
EventRecurrence
– diese EventRecurrence für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
times(times)
Konfiguriert die Regel so, dass sie nach einer bestimmten Anzahl von Wiederholungen endet.
// Creates a rule that recurs every day for ten days. var recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);
Parameter
Name | Typ | Beschreibung |
---|---|---|
times | Integer | Anzahl der Wiederholungen |
Return
RecurrenceRule
– diese RecurrenceRule für Verkettungen
until(endDate)
Konfiguriert die Regel so, dass sie an einem bestimmten Datum endet (einschließlich).
// Creates a rule that recurs every day through the end of 2013. var recurrence = CalendarApp.newRecurrence() .addDailyRule().until(new Date('December 31, 2013'));
Parameter
Name | Typ | Beschreibung |
---|---|---|
endDate | Date |
Return
RecurrenceRule
– diese RecurrenceRule für Verkettungen
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
weekStartsOn(day)
Konfiguriert, an welchem Tag eine Woche beginnt, um die Regel anzuwenden.
// Creates a weekly rule where weeks start on Monday. var recurrence = CalendarApp.newRecurrence() .addWeeklyRule().weekStartsOn(CalendarApp.Weekday.MONDAY);
Parameter
Name | Typ | Beschreibung |
---|---|---|
day | Weekday | der Tag, an dem die Woche beginnt |
Return
RecurrenceRule
– diese RecurrenceRule für Verkettungen