Class RecurrenceRule

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

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

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

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

Методы

Метод Тип возврата Краткое описание
addDailyExclusion() RecurrenceRule Добавляет правило, исключающее события ежедневно.
addDailyRule() RecurrenceRule Добавляет правило, которое заставляет событие повторяться ежедневно.
addDate(date) EventRecurrence Добавляет правило, которое заставляет событие повторяться в определенную дату.
addDateExclusion(date) EventRecurrence Добавляет правило, исключающее событие для определенной даты.
addMonthlyExclusion() RecurrenceRule Добавляет правило, исключающее события ежемесячно.
addMonthlyRule() RecurrenceRule Добавляет правило, которое заставляет событие повторяться ежемесячно.
addWeeklyExclusion() RecurrenceRule Добавляет правило, исключающее события еженедельно.
addWeeklyRule() RecurrenceRule Добавляет правило, которое заставляет событие повторяться еженедельно.
addYearlyExclusion() RecurrenceRule Добавляет правило, исключающее события ежегодно.
addYearlyRule() RecurrenceRule Добавляет правило, которое заставляет событие повторяться ежегодно.
interval(interval) RecurrenceRule Настраивает правило, которое будет применяться только в этом интервале единицы времени правила.
onlyInMonth(month) RecurrenceRule Настраивает правило, которое будет применяться только к определенному месяцу.
onlyInMonths(months) RecurrenceRule Настраивает правило, которое будет применяться только к определенным месяцам.
onlyOnMonthDay(day) RecurrenceRule Настраивает правило, которое будет применяться только к определенному дню месяца.
onlyOnMonthDays(days) RecurrenceRule Настраивает правило, которое будет применяться только к определенным дням месяца.
onlyOnWeek(week) RecurrenceRule Настраивает правило, которое будет применяться только к определенной неделе в году.
onlyOnWeekday(day) RecurrenceRule Настраивает правило, которое будет применяться только к определенному дню недели.
onlyOnWeekdays(days) RecurrenceRule Настраивает правило, которое будет применяться только к определенным дням недели.
onlyOnWeeks(weeks) RecurrenceRule Настраивает правило, которое будет применяться только к определенным неделям в году.
onlyOnYearDay(day) RecurrenceRule Настраивает правило, которое будет применяться только к определенному дню года.
onlyOnYearDays(days) RecurrenceRule Настраивает правило, которое будет применяться только к определенным дням года.
setTimeZone(timeZone) EventRecurrence Устанавливает часовой пояс для этого повторения.
times(times) RecurrenceRule Настраивает действие правила на завершение после заданного количества повторений.
until(endDate) RecurrenceRule Настраивает действие правила на указанную дату (включительно).
weekStartsOn(day) RecurrenceRule Определяет день начала недели для применения правила.

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

addDailyExclusion()

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

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

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

RecurrenceRule — новое правило 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.
var recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

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

RecurrenceRule — новое правило 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 — новое правило 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.
var recurrence = CalendarApp.newRecurrence().addMonthlyRule().times(4);

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

RecurrenceRule — новое правило 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.
var recurrence = CalendarApp.newRecurrence().addDailyRule()
    .addWeeklyExclusion().onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY).times(4);

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

RecurrenceRule — новое правило 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.
var recurrence = CalendarApp.newRecurrence().addWeeklyRule().times(10);

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

RecurrenceRule — новое правило RecurrenceRule.

Авторизация

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

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

addYearlyExclusion()

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

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

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

RecurrenceRule — новое правило RecurrenceRule.

Авторизация

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

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

addYearlyRule()

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

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

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

RecurrenceRule — новое правило 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.
var recurrence = CalendarApp.newRecurrence().addWeeklyRule().interval(4);

Параметры

Имя Тип Описание
interval Integer интервал в единице времени правила

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

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

onlyInMonth(month)

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

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

Параметры

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

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

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

onlyInMonths(months)

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

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

Параметры

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

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

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

onlyOnMonthDay(day)

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

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

Параметры

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

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

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

onlyOnMonthDays(days)

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

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

Параметры

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

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

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

onlyOnWeek(week)

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

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

Параметры

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

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

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

onlyOnWeekday(day)

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

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

Параметры

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

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

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

onlyOnWeekdays(days)

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

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

Параметры

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

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

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

onlyOnWeeks(weeks)

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

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

Параметры

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

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

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

onlyOnYearDay(day)

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

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

Параметры

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

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

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

onlyOnYearDays(days)

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

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

Параметры

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

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

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

setTimeZone(timeZone)

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

Параметры

Имя Тип Описание
timeZone String часовой пояс, указанный в «длинном» формате (например, «Америка/Нью_Йорк», как указано на 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.
var recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

Параметры

Имя Тип Описание
times Integer количество раз, которое будет повторяться

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

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

until(endDate)

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

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

Параметры

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

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

RecurrenceRule — это 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.
var recurrence = CalendarApp.newRecurrence()
    .addWeeklyRule().weekStartsOn(CalendarApp.Weekday.MONDAY);

Параметры

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

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

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