Class RecurrenceRule

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

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

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

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 Определяет день начала недели для применения правила.

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

add Daily Exclusion()

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

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

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

Recurrence Rule — новое правило RecurrenceRule

Авторизация

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

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

add Daily Rule()

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

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

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

Recurrence Rule — новое правило RecurrenceRule

Авторизация

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

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

add Date(date)

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

Параметры

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

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

Event Recurrence — это EventRecurrence для цепочки

Авторизация

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

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

add Date Exclusion(date)

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

Параметры

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

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

Event Recurrence — это EventRecurrence для цепочки

Авторизация

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

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

add Monthly Exclusion()

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

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

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

Recurrence Rule — новое правило RecurrenceRule

Авторизация

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

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

add Monthly Rule()

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

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

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

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

Recurrence Rule — новое правило RecurrenceRule

Авторизация

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

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

add Weekly Exclusion()

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

По умолчанию исключение применяется в тот же день недели, что и первое событие в серии, но это можно изменить, вызвав only On Weekday(day) или only On Weekdays(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);

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

Recurrence Rule — новое правило RecurrenceRule

Авторизация

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

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

add Weekly Rule()

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

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

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

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

Recurrence Rule — новое правило RecurrenceRule

Авторизация

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

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

add Yearly Exclusion()

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

По умолчанию исключение применяется в тот же день года, что и первое событие в серии, но это можно изменить, вызвав only On Year Day(day) или only On Year Days(days) .

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

Recurrence Rule — новое правило RecurrenceRule

Авторизация

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

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

add Yearly Rule()

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

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

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

Recurrence Rule — новое правило 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 интервал в единице времени правила

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

Recurrence Rule — это RecurrenceRule для цепочки

only In Month(month)

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

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

Параметры

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

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

Recurrence Rule — это RecurrenceRule для цепочки

only In Months(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[] месяцы

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

Recurrence Rule — это RecurrenceRule для цепочки

only On Month Day(day)

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

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

Параметры

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

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

Recurrence Rule — это RecurrenceRule для цепочки

only On Month Days(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[] дни месяца

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

Recurrence Rule — это RecurrenceRule для цепочки

only On Week(week)

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

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

Параметры

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

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

Recurrence Rule — это RecurrenceRule для цепочки

only On Weekday(day)

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

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

Параметры

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

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

Recurrence Rule — это RecurrenceRule для цепочки

only On Weekdays(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[] дни недели

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

Recurrence Rule — это RecurrenceRule для цепочки

only On Weeks(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[] недели

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

Recurrence Rule — это RecurrenceRule для цепочки

only On Year Day(day)

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

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

Параметры

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

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

Recurrence Rule — это RecurrenceRule для цепочки

only On Year Days(days)

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

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

Параметры

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

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

Recurrence Rule — это RecurrenceRule для цепочки

set Time Zone(timeZone)

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

Параметры

Имя Тип Описание
time Zone String часовой пояс, указанный в «длинном» формате (например, «Америка/Нью_Йорк», как указано на Joda.org )

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

Event Recurrence — это 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 количество повторений

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

Recurrence Rule — это 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

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

Recurrence Rule — это RecurrenceRule для цепочки

Авторизация

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

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

week Starts On(day)

Определяет день начала недели для применения правила. 

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

Параметры

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

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

Recurrence Rule — это RecurrenceRule для цепочки