Class RecurrenceRule

RecurrenceRule

Stellt eine Wiederholungsregel für eine Terminserie dar.

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

const recurrence = CalendarApp.newRecurrence().addDailyRule().times(3).interval(2).addWeeklyExclusion().times(2);
 Modifizierer wie times(times) und interval(interval) werden auf die zuletzt hinzugefügte Regel angewendet.

Methoden

MethodeRückgabetypKurzbeschreibung
addDailyExclusion()RecurrenceRuleFügt eine Regel hinzu, mit der Vorkommen täglich ausgeschlossen werden.
addDailyRule()RecurrenceRuleFügt eine Regel hinzu, die bewirkt, dass das Ereignis täglich wiederholt wird.
addDate(date)EventRecurrenceFügt eine Regel hinzu, die bewirkt, dass das Ereignis an einem bestimmten Datum wiederholt wird.
addDateExclusion(date)EventRecurrenceFügt eine Regel hinzu, mit der ein Ereignis für ein bestimmtes Datum ausgeschlossen wird.
addMonthlyExclusion()RecurrenceRuleFügt eine Regel hinzu, mit der Vorkommen monatlich ausgeschlossen werden.
addMonthlyRule()RecurrenceRuleFügt eine Regel hinzu, die bewirkt, dass das Ereignis monatlich wiederholt wird.
addWeeklyExclusion()RecurrenceRuleFügt eine Regel hinzu, mit der Vorkommen wöchentlich ausgeschlossen werden.
addWeeklyRule()RecurrenceRuleFügt eine Regel hinzu, die bewirkt, dass das Ereignis wöchentlich wiederholt wird.
addYearlyExclusion()RecurrenceRuleFügt eine Regel hinzu, mit der Vorkommen jährlich ausgeschlossen werden.
addYearlyRule()RecurrenceRuleFügt eine Regel hinzu, die bewirkt, dass das Ereignis jährlich wiederholt wird.
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 für einen bestimmten Monat gilt.
onlyInMonths(months)RecurrenceRuleKonfiguriert die Regel so, dass sie nur für bestimmte Monate gilt.
onlyOnMonthDay(day)RecurrenceRuleKonfiguriert die Regel so, dass sie nur an einem bestimmten Tag des Monats angewendet wird.
onlyOnMonthDays(days)RecurrenceRuleKonfiguriert die Regel so, dass sie nur an bestimmten Tagen des Monats angewendet wird.
onlyOnWeek(week)RecurrenceRuleKonfiguriert die Regel so, dass sie nur für eine bestimmte Woche des Jahres gilt.
onlyOnWeekday(day)RecurrenceRuleKonfiguriert die Regel so, dass sie nur an einem bestimmten Wochentag angewendet wird.
onlyOnWeekdays(days)RecurrenceRuleKonfiguriert die Regel so, dass sie nur an bestimmten Wochentagen 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 an einem bestimmten Tag des Jahres angewendet wird.
onlyOnYearDays(days)RecurrenceRuleKonfiguriert die Regel so, dass sie nur an bestimmten Tagen des Jahres angewendet wird.
setTimeZone(timeZone)EventRecurrenceLegt die Zeitzone für diese Wiederholung 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 (einschließlich) endet.
weekStartsOn(day)RecurrenceRuleKonfiguriert, an welchem Tag eine Woche beginnt, um die Regel anzuwenden.

Detaillierte Dokumentation

addDailyExclusion()

Fügt eine Regel hinzu, mit der Vorkommen täglich ausgeschlossen werden. 

// 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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 bewirkt, dass 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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 bewirkt, dass das Ereignis an einem bestimmten Datum wiederholt wird.

Parameter

NameTypBeschreibung
dateDate

Rückflug

EventRecurrence – diese EventRecurrence zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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, mit der ein Ereignis für ein bestimmtes Datum ausgeschlossen wird.

Parameter

NameTypBeschreibung
dateDate

Rückflug

EventRecurrence – diese EventRecurrence zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

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

addMonthlyExclusion()

Fügt eine Regel hinzu, mit der Vorkommen monatlich ausgeschlossen werden.

Standardmäßig wird der Ausschluss am selben Tag des Monats wie das erste Ereignis in der Serie angewendet. Dies kann jedoch durch Aufrufen von onlyOnMonthDay(day) oder onlyOnMonthDays(days) geändert werden.

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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 bewirkt, dass das Ereignis monatlich wiederholt wird.

Standardmäßig wiederholt sich das Ereignis am selben Tag des Monats wie das erste Ereignis der Serie. Dies kann jedoch durch Aufrufen von onlyOnMonthDay(day) oder onlyOnMonthDays(days) geändert werden. 

// 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

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

addWeeklyExclusion()

Fügt eine Regel hinzu, mit der Vorkommen wöchentlich ausgeschlossen werden.

Standardmäßig wird der Ausschluss am selben Wochentag wie der erste Termin in 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.
const recurrence = CalendarApp.newRecurrence()
                       .addDailyRule()
                       .addWeeklyExclusion()
                       .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY)
                       .times(4);

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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 bewirkt, dass das Ereignis wöchentlich wiederholt wird.

Standardmäßig wiederholt sich das Ereignis am selben Wochentag wie das erste Ereignis in der Serie. Dies kann jedoch durch Aufrufen von onlyOnWeekday(day) oder onlyOnWeekdays(days) geändert werden. 

// 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

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

addYearlyExclusion()

Fügt eine Regel hinzu, mit der Vorkommen jährlich ausgeschlossen werden.

Standardmäßig wird der Ausschluss am selben Tag des Jahres wie das erste Ereignis in der Serie angewendet. Dies kann jedoch durch Aufrufen von onlyOnYearDay(day) oder onlyOnYearDays(days) geändert werden.

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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 bewirkt, dass das Ereignis jährlich wiederholt wird.

Standardmäßig wiederholt sich das Ereignis am selben Tag des Jahres wie das erste Ereignis in der Reihe. Dies kann jedoch durch Aufrufen von onlyOnYearDay(day) oder onlyOnYearDays(days) geändert werden.

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().interval(4);

Parameter

NameTypBeschreibung
intervalIntegerdas Intervall in der Zeiteinheit der Regel

Rückflug

RecurrenceRule – diese RecurrenceRule zum Verketten

onlyInMonth(month)

Konfiguriert die Regel so, dass sie nur für einen bestimmten Monat gilt. 

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

Parameter

NameTypBeschreibung
monthMonthMonat

Rückflug

RecurrenceRule – diese RecurrenceRule zum Verketten

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.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyInMonths(
    [CalendarApp.Month.FEBRUARY, CalendarApp.Month.MARCH]);

Parameter

NameTypBeschreibung
monthsMonth[]die Monate

Rückflug

RecurrenceRule – diese RecurrenceRule zum Verketten

onlyOnMonthDay(day)

Konfiguriert die Regel so, 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 RecurrenceRule zum Verketten

onlyOnMonthDays(days)

Konfiguriert die Regel so, 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 RecurrenceRule zum Verketten

onlyOnWeek(week)

Konfiguriert die Regel so, 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
weekIntegerdie Woche

Rückflug

RecurrenceRule – diese RecurrenceRule zum Verketten

onlyOnWeekday(day)

Konfiguriert die Regel so, dass sie nur an einem bestimmten Wochentag angewendet wird. 

// 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 RecurrenceRule zum Verketten

onlyOnWeekdays(days)

Konfiguriert die Regel so, dass sie nur an bestimmten Wochentagen angewendet wird. 

// 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 RecurrenceRule zum Verketten

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.
const recurrence =
    CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeeks([5, 10]);

Parameter

NameTypBeschreibung
weeksInteger[]die Wochen

Rückflug

RecurrenceRule – diese RecurrenceRule zum Verketten

onlyOnYearDay(day)

Konfiguriert die Regel so, dass sie nur an einem bestimmten Tag des Jahres angewendet wird. 

// 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 RecurrenceRule zum Verketten

onlyOnYearDays(days)

Konfiguriert die Regel so, 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 RecurrenceRule zum Verketten

setTimeZone(timeZone)

Legt die Zeitzone für diese Wiederholung fest. Dies wirkt sich auf das Datum und die Uhrzeit aus, zu der Termine wiederholt werden, und darauf, ob sich der Termin mit der Sommerzeit verschiebt. Die Standardeinstellung ist die Zeitzone des Kalenders.

Parameter

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

Rückflug

EventRecurrence – diese EventRecurrence zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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.
const recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

Parameter

NameTypBeschreibung
timesIntegerDie Anzahl der Wiederholungen

Rückflug

RecurrenceRule – diese RecurrenceRule zum Verketten

until(endDate)

Konfiguriert die Regel so, dass sie an einem bestimmten Datum (einschließlich) endet. 

// 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 RecurrenceRule zum Verketten

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche 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.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().weekStartsOn(
    CalendarApp.Weekday.MONDAY);

Parameter

NameTypBeschreibung
dayWeekdayDer Tag, an dem die Woche beginnt

Rückflug

RecurrenceRule – diese RecurrenceRule zum Verketten