Эта страница переведена с помощью Cloud Translation API.

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.

Авторизация

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 для цепочки

Авторизация

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

`addMonthlyExclusion()`

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

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

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

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

Авторизация

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.

Авторизация

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.

Авторизация

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.

Авторизация

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

`addYearlyExclusion()`

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

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

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

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

Авторизация

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

`addYearlyRule()`

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

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

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

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

Авторизация

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 для цепочки

Авторизация

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 для цепочки

Авторизация

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 для цепочки