Представляет правило повторения для серии событий.
Обратите внимание, что этот класс также ведет себя как 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 для цепочки