Class EventRecurrence

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.
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)

新增會在特定日期重複進行活動的規則。

參數

名稱類型說明
dateDate

回攻員

EventRecurrence：這個用於鏈結的 EventRecurrence

授權

使用這個方法的指令碼需要授權下列一或多個範圍或相關 REST API 中的適當範圍：

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

addDateExclusion(date)

新增規則，排除特定日期的發生次數。

參數

名稱類型說明
dateDate

回攻員

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.
var 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.
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()

加入可使活動每週週期性的規則。

根據預設，活動會在每週的同一天重複。 但可透過呼叫 RecurrenceRule.onlyOnWeekday(day) 或 RecurrenceRule.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()

新增可排除每年執行次數的規則。

預設情況下，排除項目會在每年的同一天，做為首次發生事件的同一天 您可以呼叫 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)

設定這個重複週期的時區。這會影響活動週期性的日期和時間 以及活動是否隨日光節約時間開始變動。預設值為日曆的時區。

參數

名稱類型說明
timeZoneString時區，指定格式為「long」格式 (例如列於「America/New_York」 由 Joda.org 製作)

回攻員

EventRecurrence：這個用於鏈結的 EventRecurrence

授權

使用這個方法的指令碼需要授權下列一或多個範圍或相關 REST API 中的適當範圍：

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