Class RecurrenceRule

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

承認

このメソッドを使用するスクリプトでは、次のスコープの 1 つ以上、または関連する 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

承認

このメソッドを使用するスクリプトでは、次のスコープの 1 つ以上、または関連する REST API の適切なスコープによる承認が必要です。

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

addDate(date)

特定の日に予定を繰り返すルールを追加します。

パラメータ

名前型説明
dateDate

戻る

EventRecurrence - チェーン用のこの EventRecurrence

承認

このメソッドを使用するスクリプトでは、次のスコープの 1 つ以上、または関連する REST API の適切なスコープによる承認が必要です。

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

addDateExclusion(date)

特定の日付のオカレンスを除外するルールを追加します。

パラメータ

名前型説明
dateDate

戻る

EventRecurrence - チェーン用のこの EventRecurrence

承認

このメソッドを使用するスクリプトでは、次のスコープの 1 つ以上、または関連する REST API の適切なスコープによる承認が必要です。

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

addMonthlyExclusion()

毎月オカレンスを除外するルールを追加します。

デフォルトでは、除外は、該当する月の最初のイベントと同じ日に これは onlyOnMonthDay(day) または onlyOnMonthDays(days) を呼び出して変更できます。

戻る

RecurrenceRule - 新しい RecurrenceRule

承認

このメソッドを使用するスクリプトでは、次のスコープの 1 つ以上、または関連する 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

承認

このメソッドを使用するスクリプトでは、次のスコープの 1 つ以上、または関連する 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

承認

このメソッドを使用するスクリプトでは、次のスコープの 1 つ以上、または関連する 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

承認

このメソッドを使用するスクリプトでは、次のスコープの 1 つ以上、または関連する REST API の適切なスコープによる承認が必要です。

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

addYearlyExclusion()

年単位でオカレンスを除外するルールを追加します。

デフォルトでは、除外は今年の最初のイベントと同じ日に これは onlyOnYearDay(day) または onlyOnYearDays(days) を呼び出して変更できます。

戻る

RecurrenceRule - 新しい RecurrenceRule

承認

このメソッドを使用するスクリプトでは、次のスコープの 1 つ以上、または関連する REST API の適切なスコープによる承認が必要です。

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

addYearlyRule()

イベントを毎年繰り返すルールを追加します。

デフォルトでは、この予定は一連の最初の予定と同じ日に繰り返し行われますが、 これは onlyOnYearDay(day) または onlyOnYearDays(days) を呼び出して変更できます。

戻る

RecurrenceRule - 新しい RecurrenceRule

承認

このメソッドを使用するスクリプトでは、次のスコープの 1 つ以上、または関連する 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);

パラメータ

名前型説明
intervalIntegerルールの時間単位の間隔

戻る

RecurrenceRule - チェーン用のこの RecurrenceRule

onlyInMonth(month)

特定の月にのみ適用されるようにルールを設定します。 

// Creates a rule that recurs every week in February.
var recurrence = CalendarApp.newRecurrence()
    .addWeeklyRule().onlyInMonth(CalendarApp.Month.FEBRUARY);

パラメータ

名前型説明
monthMonth月

戻る

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]);

パラメータ

名前型説明
monthsMonth[]月

戻る

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

パラメータ

名前型説明
dayInteger日

戻る

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]);

パラメータ

名前型説明
daysInteger[]日

戻る

RecurrenceRule - チェーン用のこの RecurrenceRule

onlyOnWeek(week)

特定の週にのみ適用されるようにルールを設定します。 

// Creates a rule that recurs on the fifth week of every year.
var recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeek(5);

パラメータ

名前型説明
weekInteger今週

戻る

RecurrenceRule - チェーン用のこの RecurrenceRule

onlyOnWeekday(day)

特定の曜日にのみ適用されるようにルールを設定します。 

// Creates a rule that recurs every week on Wednesdays.
var recurrence = CalendarApp.newRecurrence()
    .addWeeklyRule().onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY);

パラメータ

名前型説明
dayWeekday曜日

戻る

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]);

パラメータ

名前型説明
daysWeekday[]曜日

戻る

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]);

パラメータ

名前型説明
weeksInteger[]週間

戻る

RecurrenceRule - チェーン用のこの RecurrenceRule

onlyOnYearDay(day)

特定の日付にのみ適用されるようにルールを設定します。 

// Creates a rule that recurs every year on February 15 (the 46th day).
var recurrence = CalendarApp.newRecurrence().addYearlyRule().onlyOnYearDay(46);

パラメータ

名前型説明
dayInteger日

戻る

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]);

パラメータ

名前型説明
daysInteger[]日

戻る

RecurrenceRule - チェーン用のこの RecurrenceRule

setTimeZone(timeZone)

この繰り返しのタイムゾーンを設定します。これは、予定が繰り返し実行される日時に影響します。 夏時間に切り替わるかどうかも確認できます。デフォルトはカレンダーのタイムゾーンです。

パラメータ

名前型説明
timeZoneString"long" で指定されたタイムゾーン形式（例:「America/New_York」を Joda.org 提供）

戻る

EventRecurrence - チェーン用のこの EventRecurrence

承認

このメソッドを使用するスクリプトでは、次のスコープの 1 つ以上、または関連する 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);

パラメータ

名前型説明
timesInteger繰り返す回数です

戻る

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'));

パラメータ

名前型説明
endDateDate

戻る

RecurrenceRule - チェーン用のこの RecurrenceRule

承認

このメソッドを使用するスクリプトでは、次のスコープの 1 つ以上、または関連する 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);

パラメータ

名前型説明
dayWeekday週の開始日

戻る

RecurrenceRule - チェーン用のこの RecurrenceRule