本頁面由 Cloud Translation API 翻譯而成。

Class EventRecurrence

代表活動系列的週期設定。

方法

方法	傳回類型	簡短說明
`addDailyExclusion()`	`RecurrenceRule`	新增排除每日事件的規則。
`addDailyRule()`	`RecurrenceRule`	新增規則，讓活動每天重複發生。
`addDate(date)`	`EventRecurrence`	新增規則，讓事件在特定日期重複發生。
`addDateExclusion(date)`	`EventRecurrence`	新增排除特定日期的事件規則。
`addMonthlyExclusion()`	`RecurrenceRule`	新增排除每月發生事件的規則。
`addMonthlyRule()`	`RecurrenceRule`	新增規則，讓活動每月重複發生。
`addWeeklyExclusion()`	`RecurrenceRule`	新增排除每週事件發生的規則。
`addWeeklyRule()`	`RecurrenceRule`	新增規則，讓活動每週重複發生。
`addYearlyExclusion()`	`RecurrenceRule`	新增排除每年發生的事件的規則。
`addYearlyRule()`	`RecurrenceRule`	新增規則，讓活動每年重複發生。
`setTimeZone(timeZone)`	`EventRecurrence`	設定這個週期重複事件的時區。

內容詳盡的說明文件

`addDailyExclusion()`

新增排除每日事件的規則。

// Creates a rule that recurs every week after the first 30 days.
const 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.
const 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()`

新增排除每月發生事件的規則。

根據預設，排除條件會套用至系列中第一個事件的當月同日，但您可以呼叫 RecurrenceRule.onlyOnMonthDay(day) 或 RecurrenceRule.onlyOnMonthDays(days) 來變更這個排除條件。

回攻員

RecurrenceRule - 新的 RecurrenceRule

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

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

`addMonthlyRule()`

新增規則，讓活動每月重複發生。

根據預設，事件會在該系列中第一個事件的當月同一天重複發生，但您可以呼叫 RecurrenceRule.onlyOnMonthDay(day) 或 RecurrenceRule.onlyOnMonthDays(days) 來變更這項設定。

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

回攻員

RecurrenceRule - 新的 RecurrenceRule

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

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

`addWeeklyExclusion()`

新增排除每週事件發生的規則。

根據預設，排除條件會套用至系列中第一個事件的一週同一天，但您可以呼叫 RecurrenceRule.onlyOnWeekday(day) 或 RecurrenceRule.onlyOnWeekdays(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);

回攻員

RecurrenceRule - 新的 RecurrenceRule

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

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

`addWeeklyRule()`

新增規則，讓活動每週重複發生。

根據預設，事件會在週期中第一個事件的同一天重複發生，但您可以呼叫 RecurrenceRule.onlyOnWeekday(day) 或 RecurrenceRule.onlyOnWeekdays(days) 來變更這項設定。

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

回攻員

RecurrenceRule - 新的 RecurrenceRule

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

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

`addYearlyExclusion()`

新增排除每年發生的事件的規則。

根據預設，排除條件會套用至系列中第一個事件的當年同日，但您可以呼叫 RecurrenceRule.onlyOnYearDay(day) 或 RecurrenceRule.onlyOnYearDays(days) 來變更這項設定。

回攻員

RecurrenceRule - 新的 RecurrenceRule

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

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

`addYearlyRule()`

新增規則，讓活動每年重複發生。

根據預設，事件會在該系列活動的第一個事件發生的同一天重複發生，但您可以呼叫 RecurrenceRule.onlyOnYearDay(day) 或 RecurrenceRule.onlyOnYearDays(days) 來變更這項設定。

回攻員

RecurrenceRule - 新的 RecurrenceRule

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

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

`setTimeZone(timeZone)`

設定這項週期性事件的時區。這會影響事件重複發生的日期和時間，以及事件是否會隨著日光節約時間而改變。預設為日曆的時區。

參數

名稱	類型	說明
`timeZone`	`String`	時區，以「長」格式指定 (例如 Joda.org 所列的「America/New_York」)

回攻員

EventRecurrence - 用於鏈結的 EventRecurrence

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權，或是相關 REST API 中的適當範圍：

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