本頁面由 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

授權

使用這個方法的指令碼需要授權下列一或多個範圍或相關 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`	時區，指定格式為「long」格式 (例如列於「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.
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