Class RecurrenceRule

Правило повторения

Представляет собой правило повторения для последовательности событий.

Обратите внимание, что этот класс также ведет себя подобно классу EventRecurrence , к которому он принадлежит, что позволяет создавать цепочки правил следующим образом:

const recurrence = CalendarApp.newRecurrence().addDailyRule().times(3).interval(2).addWeeklyExclusion().times(2);
Модификаторы, такие как times(times) и interval(interval) применяются к последнему добавленному правилу.

Методы

Метод Тип возвращаемого значения Краткое описание
add Daily Exclusion() Recurrence Rule Добавляет правило, исключающее события, происходящие ежедневно.
add Daily Rule() Recurrence Rule Добавляет правило, которое заставляет событие повторяться ежедневно.
add Date(date) Event Recurrence Добавляет правило, которое заставляет событие повторяться в определенную дату.
add Date Exclusion(date) Event Recurrence Добавляет правило, исключающее событие за определенную дату.
add Monthly Exclusion() Recurrence Rule Добавляет правило, исключающее события, происходящие ежемесячно.
add Monthly Rule() Recurrence Rule Добавляет правило, которое заставляет событие повторяться ежемесячно.
add Weekly Exclusion() Recurrence Rule Добавляет правило, исключающее события, происходящие еженедельно.
add Weekly Rule() Recurrence Rule Добавляет правило, которое заставляет событие повторяться еженедельно.
add Yearly Exclusion() Recurrence Rule Добавляет правило, исключающее события, происходящие ежегодно.
add Yearly Rule() Recurrence Rule Добавляет правило, которое заставляет событие повторяться ежегодно.
interval(interval) Recurrence Rule Настраивает правило таким образом, чтобы оно применялось только в указанный интервал времени, заданный правилом.
only In Month(month) Recurrence Rule Настраивает правило таким образом, чтобы оно применялось только к определенному месяцу.
only In Months(months) Recurrence Rule Настраивает правило таким образом, чтобы оно применялось только к определенным месяцам.
only On Month Day(day) Recurrence Rule Настраивает правило таким образом, чтобы оно применялось только к определенному дню месяца.
only On Month Days(days) Recurrence Rule Настраивает правило таким образом, чтобы оно применялось только к определенным дням месяца.
only On Week(week) Recurrence Rule Настраивает правило таким образом, чтобы оно применялось только к определенной неделе года.
only On Weekday(day) Recurrence Rule Настраивает правило таким образом, чтобы оно применялось только к определенному дню недели.
only On Weekdays(days) Recurrence Rule Настраивает правило таким образом, чтобы оно применялось только к определенным дням недели.
only On Weeks(weeks) Recurrence Rule Настраивает правило таким образом, чтобы оно применялось только к определенным неделям года.
only On Year Day(day) Recurrence Rule Настраивает правило таким образом, чтобы оно применялось только к определенному дню года.
only On Year Days(days) Recurrence Rule Настраивает правило таким образом, чтобы оно применялось только к определенным дням года.
set Time Zone(timeZone) Event Recurrence Устанавливает часовой пояс для этого повтора.
times(times) Recurrence Rule Настраивает правило таким образом, чтобы оно завершалось после заданного количества срабатываний.
until(endDate) Recurrence Rule Настраивает правило таким образом, чтобы оно заканчивалось в заданную дату (включительно).
week Starts On(day) Recurrence Rule Указывает, с какого дня начинается неделя, для целей применения правила.

Подробная документация

addDailyExclusion()

Добавляет правило, исключающее события, происходящие ежедневно.

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

Возвращаться

RecurrenceRule — новое правило повторения

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия или в соответствующих областях действия соответствующего REST API :

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

addDailyRule()

Добавляет правило, которое заставляет событие повторяться ежедневно.

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

Возвращаться

RecurrenceRule — новое правило повторения

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия или в соответствующих областях действия соответствующего REST API :

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

addDate(date)

Добавляет правило, которое заставляет событие повторяться в определенную дату.

Параметры

Имя Тип Описание
date Date

Возвращаться

EventRecurrence — это EventRecurrence для создания цепочек событий.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия или в соответствующих областях действия соответствующего REST API :

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

addDateExclusion(date)

Добавляет правило, исключающее событие за определенную дату.

Параметры

Имя Тип Описание
date Date

Возвращаться

EventRecurrence — это EventRecurrence для создания цепочек событий.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия или в соответствующих областях действия соответствующего REST API :

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

addMonthlyExclusion()

Добавляет правило, исключающее события, происходящие ежемесячно.

По умолчанию исключение применяется к тому же дню месяца, что и первое событие в серии, но это можно изменить, вызвав методы onlyOnMonthDay(day) или onlyOnMonthDays(days) .

Возвращаться

RecurrenceRule — новое правило повторения

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия или в соответствующих областях действия соответствующего REST API :

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

addMonthlyRule()

Добавляет правило, которое заставляет событие повторяться ежемесячно.

По умолчанию событие повторяется в тот же день месяца, что и первое событие в серии, но это можно изменить, вызвав методы onlyOnMonthDay(day) или onlyOnMonthDays(days) .

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

Возвращаться

RecurrenceRule — новое правило повторения

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия или в соответствующих областях действия соответствующего REST API :

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

addWeeklyExclusion()

Добавляет правило, исключающее события, происходящие еженедельно.

По умолчанию исключение применяется к тому же дню недели, что и первое событие в серии, но это можно изменить, вызвав методы onlyOnWeekday(day) или onlyOnWeekdays(days) .

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

Возвращаться

RecurrenceRule — новое правило повторения

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия или в соответствующих областях действия соответствующего REST API :

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

addWeeklyRule()

Добавляет правило, которое заставляет событие повторяться еженедельно.

По умолчанию событие повторяется в тот же день недели, что и первое событие в серии, но это можно изменить, вызвав методы onlyOnWeekday(day) или onlyOnWeekdays(days) .

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

Возвращаться

RecurrenceRule — новое правило повторения

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия или в соответствующих областях действия соответствующего REST API :

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

addYearlyExclusion()

Добавляет правило, исключающее события, происходящие ежегодно.

По умолчанию исключение применяется к тому же дню года, что и первое событие в серии, но это можно изменить, вызвав функции onlyOnYearDay(day) или onlyOnYearDays(days) .

Возвращаться

RecurrenceRule — новое правило повторения

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия или в соответствующих областях действия соответствующего REST API :

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

addYearlyRule()

Добавляет правило, которое заставляет событие повторяться ежегодно.

По умолчанию событие повторяется в тот же день года, что и первое событие в серии, но это можно изменить, вызвав методы onlyOnYearDay(day) или onlyOnYearDays(days) .

Возвращаться

RecurrenceRule — новое правило повторения

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия или в соответствующих областях действия соответствующего REST API :

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

interval(interval)

Настраивает правило таким образом, чтобы оно применялось только в указанный интервал времени, заданный правилом.

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

Параметры

Имя Тип Описание
interval Integer интервал в единицах времени, указанных в правиле

Возвращаться

RecurrenceRule — это правило повторения для создания цепочек вызовов.


onlyInMonth(month)

Настраивает правило таким образом, чтобы оно применялось только к определенному месяцу.

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

Параметры

Имя Тип Описание
month Month месяц

Возвращаться

RecurrenceRule — это правило повторения для создания цепочек вызовов.


onlyInMonths(months)

Настраивает правило таким образом, чтобы оно применялось только к определенным месяцам.

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

Параметры

Имя Тип Описание
months Month[] месяцы

Возвращаться

RecurrenceRule — это правило повторения для создания цепочек вызовов.


onlyOnMonthDay(day)

Настраивает правило таким образом, чтобы оно применялось только к определенному дню месяца.

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

Параметры

Имя Тип Описание
day Integer день месяца

Возвращаться

RecurrenceRule — это правило повторения для создания цепочек вызовов.


onlyOnMonthDays(days)

Настраивает правило таким образом, чтобы оно применялось только к определенным дням месяца.

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

Параметры

Имя Тип Описание
days Integer[] дни месяца

Возвращаться

RecurrenceRule — это правило повторения для создания цепочек вызовов.


onlyOnWeek(week)

Настраивает правило таким образом, чтобы оно применялось только к определенной неделе года.

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

Параметры

Имя Тип Описание
week Integer неделя

Возвращаться

RecurrenceRule — это правило повторения для создания цепочек вызовов.


onlyOnWeekday(day)

Настраивает правило таким образом, чтобы оно применялось только к определенному дню недели.

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

Параметры

Имя Тип Описание
day Weekday день недели

Возвращаться

RecurrenceRule — это правило повторения для создания цепочек вызовов.


onlyOnWeekdays(days)

Настраивает правило таким образом, чтобы оно применялось только к определенным дням недели.

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

Параметры

Имя Тип Описание
days Weekday[] дни недели

Возвращаться

RecurrenceRule — это правило повторения для создания цепочек вызовов.


onlyOnWeeks(weeks)

Настраивает правило таким образом, чтобы оно применялось только к определенным неделям года.

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

Параметры

Имя Тип Описание
weeks Integer[] недели

Возвращаться

RecurrenceRule — это правило повторения для создания цепочек вызовов.


onlyOnYearDay(day)

Настраивает правило таким образом, чтобы оно применялось только к определенному дню года.

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

Параметры

Имя Тип Описание
day Integer день года

Возвращаться

RecurrenceRule — это правило повторения для создания цепочек вызовов.


onlyOnYearDays(days)

Настраивает правило таким образом, чтобы оно применялось только к определенным дням года.

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

Параметры

Имя Тип Описание
days Integer[] дни года

Возвращаться

RecurrenceRule — это правило повторения для создания цепочек вызовов.


setTimeZone(timeZone)

Задает часовой пояс для этого повторения. Это влияет на дату и время повторения событий, а также на то, будет ли событие сдвигаться в зависимости от перехода на летнее время. По умолчанию используется часовой пояс календаря.

Параметры

Имя Тип Описание
time Zone String Часовой пояс, указанный в "длинном" формате (например, 'America/New_York', как указано на Joda.org ).

Возвращаться

EventRecurrence — это EventRecurrence для создания цепочек событий.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия или в соответствующих областях действия соответствующего REST API :

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

times(times)

Настраивает правило таким образом, чтобы оно завершалось после заданного количества срабатываний.

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

Параметры

Имя Тип Описание
times Integer количество повторений

Возвращаться

RecurrenceRule — это правило повторения для создания цепочек вызовов.


until(endDate)

Настраивает правило таким образом, чтобы оно заканчивалось в заданную дату (включительно).

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

Параметры

Имя Тип Описание
end Date Date

Возвращаться

RecurrenceRule — это правило повторения для создания цепочек вызовов.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия или в соответствующих областях действия соответствующего REST API :

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

weekStartsOn(day)

Указывает, с какого дня начинается неделя, для целей применения правила.

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

Параметры

Имя Тип Описание
day Weekday день, с которого начинается неделя

Возвращаться

RecurrenceRule — это правило повторения для создания цепочек вызовов.