Class RecurrenceRule

RecurrenceRule

Eine Wiederholungsregel für eine Terminserie

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

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 Vorkommen auf täglicher Basis ausschließt.
addDailyRule()RecurrenceRuleFügt eine Regel hinzu, durch die der Termin täglich wiederholt wird.
addDate(date)EventRecurrenceFügt eine Regel hinzu, durch die der Termin an einem bestimmten Datum wiederholt wird.
addDateExclusion(date)EventRecurrenceFügt eine Regel hinzu, die einen Fall an einem bestimmten Datum ausschließt.
addMonthlyExclusion()RecurrenceRuleFügt eine Regel hinzu, die Vorkommen auf monatlicher Basis ausschließt.
addMonthlyRule()RecurrenceRuleFügt eine Regel hinzu, durch die sich das Ereignis jeden Monat wiederholt.
addWeeklyExclusion()RecurrenceRuleFügt eine Regel hinzu, die Vorkommen auf wöchentlicher Basis 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 Vorkommen auf Jahresbasis ausschließt.
addYearlyRule()RecurrenceRuleFügt eine Regel hinzu, die dafür sorgt, dass sich der Termin jährlich wiederholt.
interval(interval)RecurrenceRuleMit dieser Richtlinie wird die Regel so konfiguriert, dass sie nur in diesem Intervall der Zeiteinheit der Regel gilt.
onlyInMonth(month)RecurrenceRuleMit dieser Richtlinie wird die Regel so konfiguriert, 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)RecurrenceRuleMit dieser Richtlinie wird die Regel so konfiguriert, dass sie nur für einen bestimmten Tag des Monats gilt.
onlyOnMonthDays(days)RecurrenceRuleMit dieser Richtlinie wird die Regel so konfiguriert, dass sie nur für bestimmte Tage des Monats gilt.
onlyOnWeek(week)RecurrenceRuleMit dieser Richtlinie wird die Regel so konfiguriert, dass sie nur für eine bestimmte Woche im Jahr gilt.
onlyOnWeekday(day)RecurrenceRuleMit dieser Richtlinie wird die Regel so konfiguriert, dass sie nur für einen bestimmten Wochentag gilt.
onlyOnWeekdays(days)RecurrenceRuleKonfiguriert die Regel so, dass sie nur für bestimmte Wochentage gilt.
onlyOnWeeks(weeks)RecurrenceRuleKonfiguriert die Regel so, dass sie nur für bestimmte Wochen des Jahres gilt.
onlyOnYearDay(day)RecurrenceRuleMit dieser Richtlinie wird die Regel so konfiguriert, dass sie nur für einen bestimmten Tag im Jahr gilt.
onlyOnYearDays(days)RecurrenceRuleMit dieser Richtlinie wird die Regel so konfiguriert, 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 Vorkommen auf täglicher Basis ausschließt.

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

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:

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

addDailyRule()

Fügt eine Regel hinzu, durch die der Termin täglich wiederholt wird.

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

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:

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

addDate(date)

Fügt eine Regel hinzu, durch die der Termin an einem bestimmten Datum wiederholt wird.

Parameter

NameTypBeschreibung
dateDate

Rückflug

EventRecurrence – diese EventRecurrence für die Verkettung

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:

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

addDateExclusion(date)

Fügt eine Regel hinzu, die einen Fall an einem bestimmten Datum ausschließt.

Parameter

NameTypBeschreibung
dateDate

Rückflug

EventRecurrence – diese EventRecurrence für die Verkettung

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:

  • 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 angewendet wie das erste Ereignis im Dieser Wert kann durch Aufrufen von onlyOnMonthDay(day) oder onlyOnMonthDays(days) geändert werden.

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:

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

addMonthlyRule()

Fügt eine Regel hinzu, durch die sich das Ereignis jeden Monat wiederholt.

Standardmäßig wird der Termin am selben Tag des Monats wiederholt wie der erste Termin der Serie. Dieser kann jedoch 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);

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:

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

addWeeklyExclusion()

Fügt eine Regel hinzu, die Vorkommen auf wöchentlicher Basis ausschließt.

Standardmäßig wird der Ausschluss am selben Wochentag wie das erste Ereignis im Dieser Wert kann 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);

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:

  • 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 wiederholt sich der Termin am selben Wochentag wie der erste Termin der Serie. Dieser kann jedoch 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);

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:

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

addYearlyExclusion()

Fügt eine Regel hinzu, die Vorkommen auf Jahresbasis ausschließt.

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

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:

  • 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 der Serie. Dieser kann jedoch durch Aufrufen von onlyOnYearDay(day) oder onlyOnYearDays(days) geändert werden.

Rückflug

RecurrenceRule – die neue RecurrenceRule

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:

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

interval(interval)

Mit dieser Richtlinie wird die Regel so konfiguriert, dass sie nur in diesem Intervall der Zeiteinheit der Regel gilt.

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

Parameter

NameTypBeschreibung
intervalIntegerdas Intervall in der Zeiteinheit der Regel

Rückflug

RecurrenceRule – diese RecurrenceRule für Verkettung


onlyInMonth(month)

Mit dieser Richtlinie wird die Regel so konfiguriert, dass sie nur für einen bestimmten Monat gilt.

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

Parameter

NameTypBeschreibung
monthMonthder Monat

Rückflug

RecurrenceRule – diese RecurrenceRule für Verkettung


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

Rückflug

RecurrenceRule – diese RecurrenceRule für Verkettung


onlyOnMonthDay(day)

Mit dieser Richtlinie wird die Regel so konfiguriert, dass sie nur für einen bestimmten Tag des Monats gilt.

// 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

Rückflug

RecurrenceRule – diese RecurrenceRule für Verkettung


onlyOnMonthDays(days)

Mit dieser Richtlinie wird die Regel so konfiguriert, dass sie nur für bestimmte Tage des Monats gilt.

// 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[]die Tage des Monats

Rückflug

RecurrenceRule – diese RecurrenceRule für Verkettung


onlyOnWeek(week)

Mit dieser Richtlinie wird die Regel so konfiguriert, dass sie nur für eine bestimmte Woche im Jahr gilt.

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

Parameter

NameTypBeschreibung
weekIntegerdie Woche

Rückflug

RecurrenceRule – diese RecurrenceRule für Verkettung


onlyOnWeekday(day)

Mit dieser Richtlinie wird die Regel so konfiguriert, 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

Rückflug

RecurrenceRule – diese RecurrenceRule für Verkettung


onlyOnWeekdays(days)

Konfiguriert die Regel so, dass sie nur für bestimmte Wochentage gilt.

// 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

Rückflug

RecurrenceRule – diese RecurrenceRule für Verkettung


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

Rückflug

RecurrenceRule – diese RecurrenceRule für Verkettung


onlyOnYearDay(day)

Mit dieser Richtlinie wird die Regel so konfiguriert, dass sie nur für einen bestimmten Tag im Jahr gilt.

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

Parameter

NameTypBeschreibung
dayIntegerden Tag des Jahres

Rückflug

RecurrenceRule – diese RecurrenceRule für Verkettung


onlyOnYearDays(days)

Mit dieser Richtlinie wird die Regel so konfiguriert, 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

Rückflug

RecurrenceRule – diese RecurrenceRule für Verkettung


setTimeZone(timeZone)

Legt die Zeitzone für diese Serie fest. Dies wirkt sich auf Datum und Uhrzeit des wiederkehrenden Termins aus, und ob der Termin auf Sommerzeit umgestellt wird. Die Standardeinstellung ist die Zeitzone des Kalenders.

Parameter

NameTypBeschreibung
timeZoneStringdie in „long“ angegebene Zeitzone Format (z.B. 'America/New_York', wie aufgeführt von Joda.org

Rückflug

EventRecurrence – diese EventRecurrence für die Verkettung

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:

  • 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
timesIntegerdie Anzahl der Wiederholungen

Rückflug

RecurrenceRule – diese RecurrenceRule für Verkettung


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

Rückflug

RecurrenceRule – diese RecurrenceRule für Verkettung

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:

  • 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
dayWeekdayden Tag, an dem die Woche beginnt

Rückflug

RecurrenceRule – diese RecurrenceRule für Verkettung