Class RecurrenceRule

Wiederholungsregel

Stellt eine Wiederholungsregel für eine Ereignisreihe dar.

Beachten Sie, dass sich diese Klasse auch wie die EventRecurrence verhält, zu der sie gehört. So können Sie die Regelerstellung so verketten: 

const recurrence = CalendarApp.newRecurrence().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()RecurrenceRuleHiermit wird eine Regel hinzugefügt, die tägliche Vorkommnisse ausschließt.
addDailyRule()RecurrenceRuleHiermit wird eine Regel hinzugefügt, durch die das Ereignis täglich wiederholt wird.
addDate(date)EventRecurrenceHiermit wird eine Regel hinzugefügt, durch die das Ereignis an einem bestimmten Datum wiederholt wird.
addDateExclusion(date)EventRecurrenceHiermit wird eine Regel hinzugefügt, durch die ein Auftreten für ein bestimmtes Datum ausgeschlossen wird.
addMonthlyExclusion()RecurrenceRuleHiermit wird eine Regel hinzugefügt, die Vorkommnisse auf monatlicher Basis ausschließt.
addMonthlyRule()RecurrenceRuleHiermit wird eine Regel hinzugefügt, durch die das Ereignis monatlich wiederholt wird.
addWeeklyExclusion()RecurrenceRuleHiermit wird eine Regel hinzugefügt, durch die Vorkommnisse auf wöchentlicher Basis ausgeschlossen werden.
addWeeklyRule()RecurrenceRuleHiermit wird eine Regel hinzugefügt, durch die das Ereignis wöchentlich wiederholt wird.
addYearlyExclusion()RecurrenceRuleHiermit wird eine Regel hinzugefügt, die Vorkommnisse auf Jahresbasis ausschließt.
addYearlyRule()RecurrenceRuleHiermit wird eine Regel hinzugefügt, durch die das Ereignis jährlich wiederholt wird.
interval(interval)RecurrenceRuleHiermit wird konfiguriert, dass die Regel nur in diesem Intervall der Zeiteinheit der Regel angewendet wird.
onlyInMonth(month)RecurrenceRuleDie Regel wird so konfiguriert, dass sie nur auf einen bestimmten Monat angewendet wird.
onlyInMonths(months)RecurrenceRuleHiermit wird die Regel so konfiguriert, dass sie nur auf bestimmte Monate angewendet wird.
onlyOnMonthDay(day)RecurrenceRuleHiermit wird die Regel so konfiguriert, dass sie nur an einem bestimmten Tag des Monats angewendet wird.
onlyOnMonthDays(days)RecurrenceRuleHiermit wird die Regel so konfiguriert, dass sie nur an bestimmten Tagen des Monats angewendet wird.
onlyOnWeek(week)RecurrenceRuleDie Regel wird so konfiguriert, dass sie nur für eine bestimmte Woche des Jahres gilt.
onlyOnWeekday(day)RecurrenceRuleDie Regel wird so konfiguriert, dass sie nur an einem bestimmten Wochentag gilt.
onlyOnWeekdays(days)RecurrenceRuleHiermit wird die Regel so konfiguriert, dass sie nur an bestimmten Wochentagen gilt.
onlyOnWeeks(weeks)RecurrenceRuleHiermit wird die Regel so konfiguriert, dass sie nur für bestimmte Wochen des Jahres gilt.
onlyOnYearDay(day)RecurrenceRuleDie Regel wird so konfiguriert, dass sie nur an einem bestimmten Tag des Jahres gilt.
onlyOnYearDays(days)RecurrenceRuleHiermit wird die Regel so konfiguriert, dass sie nur an bestimmten Tagen des Jahres angewendet wird.
setTimeZone(timeZone)EventRecurrenceHier legen Sie die Zeitzone für diese Wiederholung fest.
times(times)RecurrenceRuleDie Regel wird so konfiguriert, dass sie nach einer bestimmten Anzahl von Vorkommnissen endet.
until(endDate)RecurrenceRuleDie Regel endet an einem bestimmten Datum (inklusive).
weekStartsOn(day)RecurrenceRuleHiermit wird konfiguriert, an welchem Tag die Woche beginnt, um die Regel anzuwenden.

Detaillierte Dokumentation

addDailyExclusion()

Hiermit wird eine Regel hinzugefügt, die tägliche Vorkommnisse ausschließt. 

// Creates a rule that recurs every week after the first 30 days.
const recurrence =
    CalendarApp.newRecurrence().addWeeklyRule().addDailyExclusion().times(30);

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addDailyRule()

Hiermit wird eine Regel hinzugefügt, durch die das Ereignis täglich wiederholt wird. 

// Creates a rule that recurs every day for ten days.
const recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addDate(date)

Hiermit wird eine Regel hinzugefügt, durch die das Ereignis an einem bestimmten Datum wiederholt wird.

Parameter

NameTypBeschreibung
dateDate

Rückflug

EventRecurrence – diese wiederkehrende Veranstaltung für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addDateExclusion(date)

Hiermit wird eine Regel hinzugefügt, durch die ein Auftreten für ein bestimmtes Datum ausgeschlossen wird.

Parameter

NameTypBeschreibung
dateDate

Rückflug

EventRecurrence – diese wiederkehrende Veranstaltung für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addMonthlyExclusion()

Hiermit wird eine Regel hinzugefügt, die Vorkommnisse auf monatlicher Basis ausschließt.

Standardmäßig wird der Ausschluss am selben Tag des Monats wie das erste Ereignis in der Reihe angewendet. Sie können dies jedoch ändern, indem Sie onlyOnMonthDay(day) oder onlyOnMonthDays(days) aufrufen.

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addMonthlyRule()

Hiermit wird eine Regel hinzugefügt, durch die das Ereignis monatlich wiederholt wird.

Standardmäßig wird das Ereignis am selben Tag des Monats wie das erste Ereignis in der Reihe wiederholt. Das lässt sich jedoch durch Aufrufen von onlyOnMonthDay(day) oder onlyOnMonthDays(days) ändern. 

// Creates a rule that recurs every month for three months.
const recurrence = CalendarApp.newRecurrence().addMonthlyRule().times(4);

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addWeeklyExclusion()

Hiermit wird eine Regel hinzugefügt, durch die Vorkommnisse auf wöchentlicher Basis ausgeschlossen werden.

Standardmäßig wird der Ausschluss am selben Wochentag wie das erste Ereignis in der Reihe angewendet. Sie können dies jedoch ändern, indem Sie onlyOnWeekday(day) oder onlyOnWeekdays(days) aufrufen. 

// Creates a rule that recurs every day except the first four Wednesdays.
const recurrence = CalendarApp.newRecurrence()
                       .addDailyRule()
                       .addWeeklyExclusion()
                       .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY)
                       .times(4);

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addWeeklyRule()

Hiermit wird eine Regel hinzugefügt, durch die das Ereignis wöchentlich wiederholt wird.

Standardmäßig wird das Ereignis am selben Wochentag wie das erste Ereignis in der Reihe wiederholt. Das lässt sich jedoch durch Aufrufen von onlyOnWeekday(day) oder onlyOnWeekdays(days) ändern. 

// Creates a rule that recurs every week for ten weeks.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().times(10);

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addYearlyExclusion()

Hiermit wird eine Regel hinzugefügt, die Vorkommnisse auf Jahresbasis ausschließt.

Standardmäßig wird der Ausschluss am selben Tag des Jahres wie das erste Ereignis in der Reihe angewendet. Das lässt sich jedoch durch Aufrufen von onlyOnYearDay(day) oder onlyOnYearDays(days) ändern.

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addYearlyRule()

Hiermit wird eine Regel hinzugefügt, durch die das Ereignis jährlich wiederholt wird.

Standardmäßig wird das Ereignis am selben Tag des Jahres wie das erste Ereignis in der Reihe wiederholt. Sie können dies jedoch ändern, indem Sie onlyOnYearDay(day) oder onlyOnYearDays(days) aufrufen.

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

interval(interval)

Hiermit wird konfiguriert, dass die Regel nur in diesem Intervall der Zeiteinheit der Regel angewendet wird. 

// Creates a rule that recurs every fourth week.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().interval(4);

Parameter

NameTypBeschreibung
intervalIntegerdas Intervall in der Zeiteinheit der Regel

Rückflug

RecurrenceRule – diese Wiederholungsregel für die Verkettung

onlyInMonth(month)

Die Regel wird so konfiguriert, dass sie nur auf einen bestimmten Monat angewendet wird. 

// Creates a rule that recurs every week in February.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyInMonth(
    CalendarApp.Month.FEBRUARY);

Parameter

NameTypBeschreibung
monthMonthdes Monats

Rückflug

RecurrenceRule – diese Wiederholungsregel für die Verkettung

onlyInMonths(months)

Hiermit wird die Regel so konfiguriert, dass sie nur auf bestimmte Monate angewendet wird. 

// Creates a rule that recurs every week in February and March.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyInMonths(
    [CalendarApp.Month.FEBRUARY, CalendarApp.Month.MARCH]);

Parameter

NameTypBeschreibung
monthsMonth[]die Monate

Rückflug

RecurrenceRule – diese Wiederholungsregel für die Verkettung

onlyOnMonthDay(day)

Hiermit wird die Regel so konfiguriert, dass sie nur an einem bestimmten Tag des Monats angewendet wird. 

// Creates a rule that recurs every month on the fifth day of the month.
const recurrence =
    CalendarApp.newRecurrence().addMonthlyRule().onlyOnMonthDay(5);

Parameter

NameTypBeschreibung
dayIntegerTag des Monats

Rückflug

RecurrenceRule – diese Wiederholungsregel für die Verkettung

onlyOnMonthDays(days)

Hiermit wird die Regel so konfiguriert, dass sie nur an bestimmten Tagen des Monats angewendet wird. 

// Creates a rule that recurs every month on the first and fifteenth day of the
// month.
const recurrence =
    CalendarApp.newRecurrence().addMonthlyRule().onlyOnMonthDays([1, 15]);

Parameter

NameTypBeschreibung
daysInteger[]die Tage des Monats

Rückflug

RecurrenceRule – diese Wiederholungsregel für die Verkettung

onlyOnWeek(week)

Die Regel wird so konfiguriert, dass sie nur für eine bestimmte Woche des Jahres gilt. 

// Creates a rule that recurs on the fifth week of every year.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeek(5);

Parameter

NameTypBeschreibung
weekIntegerder Woche

Rückflug

RecurrenceRule – diese Wiederholungsregel für die Verkettung

onlyOnWeekday(day)

Die Regel wird so konfiguriert, dass sie nur an einem bestimmten Wochentag gilt. 

// Creates a rule that recurs every week on Wednesdays.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeekday(
    CalendarApp.Weekday.WEDNESDAY);

Parameter

NameTypBeschreibung
dayWeekdayWochentag

Rückflug

RecurrenceRule – diese Wiederholungsregel für die Verkettung

onlyOnWeekdays(days)

Hiermit wird die Regel so konfiguriert, dass sie nur an bestimmten Wochentagen gilt. 

// Creates a rule that recurs every week on Tuesdays and Thursdays.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeekdays(
    [CalendarApp.Weekday.TUESDAY, CalendarApp.Weekday.THURSDAY]);

Parameter

NameTypBeschreibung
daysWeekday[]die Wochentage

Rückflug

RecurrenceRule – diese Wiederholungsregel für die Verkettung

onlyOnWeeks(weeks)

Hiermit wird die Regel so konfiguriert, dass sie nur für bestimmte Wochen des Jahres gilt. 

// Creates a rule that recurs on the fifth and tenth weeks of every year.
const recurrence =
    CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeeks([5, 10]);

Parameter

NameTypBeschreibung
weeksInteger[]Wochen

Rückflug

RecurrenceRule – diese Wiederholungsregel für die Verkettung

onlyOnYearDay(day)

Die Regel wird so konfiguriert, dass sie nur an einem bestimmten Tag des Jahres gilt. 

// Creates a rule that recurs every year on February 15 (the 46th day).
const recurrence =
    CalendarApp.newRecurrence().addYearlyRule().onlyOnYearDay(46);

Parameter

NameTypBeschreibung
dayIntegerTag des Jahres

Rückflug

RecurrenceRule – diese Wiederholungsregel für die Verkettung

onlyOnYearDays(days)

Hiermit wird die Regel so konfiguriert, dass sie nur an bestimmten Tagen des Jahres angewendet wird. 

// Creates a rule that recurs every year on January 20 and February 15.
const recurrence =
    CalendarApp.newRecurrence().addYearlyRule().onlyOnYearDay([20, 46]);

Parameter

NameTypBeschreibung
daysInteger[]die Tage des Jahres

Rückflug

RecurrenceRule – diese Wiederholungsregel für die Verkettung

setTimeZone(timeZone)

Hier legen Sie die Zeitzone für diese Wiederholung fest. Das wirkt sich auf das Datum und die Uhrzeit aus, an dem bzw. der die Ereignisse wiederkehren, und darauf, ob das Ereignis mit der Sommerzeit verschoben wird. Standardmäßig ist die Zeitzone des Kalenders festgelegt.

Parameter

NameTypBeschreibung
timeZoneStringdie Zeitzone im Langformat (z.B. „America/New_York“, wie von Joda.org aufgeführt)

Rückflug

EventRecurrence – diese wiederkehrende Veranstaltung für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

times(times)

Die Regel wird so konfiguriert, dass sie nach einer bestimmten Anzahl von Vorkommnissen endet. 

// Creates a rule that recurs every day for ten days.
const recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

Parameter

NameTypBeschreibung
timesIntegerdie Anzahl der Wiederholungen

Rückflug

RecurrenceRule – diese Wiederholungsregel für die Verkettung

until(endDate)

Die Regel endet an einem bestimmten Datum (inklusive). 

// Creates a rule that recurs every day through the end of 2013.
const recurrence = CalendarApp.newRecurrence().addDailyRule().until(
    new Date('December 31, 2013'));

Parameter

NameTypBeschreibung
endDateDate

Rückflug

RecurrenceRule – diese Wiederholungsregel für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

weekStartsOn(day)

Hiermit wird konfiguriert, an welchem Tag die Woche beginnt, um die Regel anzuwenden. 

// Creates a weekly rule where weeks start on Monday.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().weekStartsOn(
    CalendarApp.Weekday.MONDAY);

Parameter

NameTypBeschreibung
dayWeekdayder Tag, an dem die Woche beginnt

Rückflug

RecurrenceRule – diese Wiederholungsregel für die Verkettung