Class RecurrenceRule

RecurrenceRule

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

MethodeRückgabetypKurzbeschreibung
addDailyExclusion()RecurrenceRuleFügt eine Regel hinzu, die Termine täglich ausschließt.
addDailyRule()RecurrenceRuleFügt eine Regel hinzu, die dafür sorgt, dass sich der Termin täglich wiederholt.
addDate(date)EventRecurrenceFügt eine Regel hinzu, die dafür sorgt, dass sich der Termin an einem bestimmten Datum wiederholt.
addDateExclusion(date)EventRecurrenceFügt eine Regel hinzu, die ein Vorkommen für ein bestimmtes Datum ausschließt.
addMonthlyExclusion()RecurrenceRuleFügt eine Regel hinzu, die Vorkommen auf monatlicher Basis ausschließt.
addMonthlyRule()RecurrenceRuleFügt eine Regel hinzu, die dafür sorgt, dass sich der Termin monatlich wiederholt.
addWeeklyExclusion()RecurrenceRuleFügt eine Regel hinzu, die Vorkommen wöchentlich ausschließt.
addWeeklyRule()RecurrenceRuleFügt eine Regel hinzu, die dafür sorgt, dass sich der Termin wöchentlich wiederholt.
addYearlyExclusion()RecurrenceRuleFügt eine Regel hinzu, die Termine jährlich ausschließt.
addYearlyRule()RecurrenceRuleFügt eine Regel hinzu, die dafür sorgt, dass sich der Termin jährlich wiederholt.
interval(interval)RecurrenceRuleKonfiguriert die Regel so, dass sie nur in diesem Intervall der Zeiteinheit der Regel angewendet wird.
onlyInMonth(month)RecurrenceRuleKonfiguriert die Regel so, dass sie nur auf einen bestimmten Monat angewendet wird.
onlyInMonths(months)RecurrenceRuleKonfiguriert die Regel so, dass sie nur für bestimmte Monate gilt.
onlyOnMonthDay(day)RecurrenceRuleKonfiguriert die Regel so, dass sie nur auf einen bestimmten Tag des Monats angewendet wird.
onlyOnMonthDays(days)RecurrenceRuleKonfiguriert die Regel so, dass sie nur auf bestimmte Tage des Monats angewendet wird.
onlyOnWeek(week)RecurrenceRuleKonfiguriert die Regel so, dass sie nur auf eine bestimmte Woche des Jahres angewendet wird.
onlyOnWeekday(day)RecurrenceRuleKonfiguriert die Regel so, dass sie nur für einen bestimmten Wochentag gilt.
onlyOnWeekdays(days)RecurrenceRuleKonfiguriert die Regel so, dass sie nur auf bestimmte Wochentage angewendet wird.
onlyOnWeeks(weeks)RecurrenceRuleKonfiguriert die Regel so, dass sie nur für bestimmte Wochen des Jahres gilt.
onlyOnYearDay(day)RecurrenceRuleKonfiguriert die Regel so, dass sie nur für einen bestimmten Tag des Jahres gilt.
onlyOnYearDays(days)RecurrenceRuleKonfiguriert die Regel so, dass sie nur für bestimmte Tage des Jahres gilt.
setTimeZone(timeZone)EventRecurrenceLegt die Zeitzone für diese Serie fest.
times(times)RecurrenceRuleKonfiguriert die Regel so, dass sie nach einer bestimmten Anzahl von Wiederholungen endet.
until(endDate)RecurrenceRuleKonfiguriert die Regel so, dass sie an einem bestimmten Datum endet (einschließlich).
weekStartsOn(day)RecurrenceRuleKonfiguriert, 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

NameTypBeschreibung
dateDate

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

NameTypBeschreibung
dateDate

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

NameTypBeschreibung
intervalIntegerdas 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

NameTypBeschreibung
monthMonthder 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

NameTypBeschreibung
monthsMonth[]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

NameTypBeschreibung
dayIntegerder 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

NameTypBeschreibung
daysInteger[]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

NameTypBeschreibung
weekIntegerdie 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

NameTypBeschreibung
dayWeekdayder 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

NameTypBeschreibung
daysWeekday[]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

NameTypBeschreibung
weeksInteger[]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

NameTypBeschreibung
dayIntegerder 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

NameTypBeschreibung
daysInteger[]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

NameTypBeschreibung
timeZoneStringdie 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

NameTypBeschreibung
timesIntegerAnzahl 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

NameTypBeschreibung
endDateDate

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

NameTypBeschreibung
dayWeekdayder Tag, an dem die Woche beginnt

Return

RecurrenceRule – diese RecurrenceRule für Verkettungen