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 — กฎการเกิดซ้ําใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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 — กฎการเกิดซ้ําใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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 — กฎการเกิดซ้ําใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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 — กฎการเกิดซ้ําใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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 — กฎการเกิดซ้ําใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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 — กฎการเกิดซ้ําใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

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

addYearlyExclusion()

เพิ่มกฎที่ยกเว้นรายการรายปี

โดยค่าเริ่มต้น การยกเว้นจะมีผลในวันเดียวกันของปีเช่นเดียวกับเหตุการณ์แรกในชุด อย่างไรก็ตาม การยกเว้นนี้ได้โดยการเรียกใช้ onlyOnYearDay(day) หรือ onlyOnYearDays(days)

ไปกลับ

RecurrenceRule — กฎการเกิดซ้ําใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

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

addYearlyRule()

เพิ่มกฎที่ทําให้กิจกรรมเกิดซ้ําทุกปี

โดยค่าเริ่มต้น กิจกรรมจะเกิดขึ้นในวันเดียวกันของปีเช่นเดียวกับกิจกรรมแรกในชุด แต่สามารถแก้ไขได้โดยการโทร onlyOnYearDay(day) หรือ onlyOnYearDays(days)

ไปกลับ

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 — กฎการเกิดซ้ําสําหรับเชนนี้


onlyInMonth(month)

กําหนดค่ากฎเพื่อให้นําไปใช้กับเดือนที่ต้องการเท่านั้น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
monthMonthเดือน

ไปกลับ

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 — กฎการเกิดซ้ําสําหรับเชนนี้


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 — กฎการเกิดซ้ําสําหรับเชนนี้


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 — กฎการเกิดซ้ําสําหรับเชนนี้


onlyOnWeek(week)

กําหนดค่ากฎให้นําไปใช้กับสัปดาห์ของปีที่ต้องการเท่านั้น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
weekIntegerสัปดาห์

ไปกลับ

RecurrenceRule — กฎการเกิดซ้ําสําหรับเชนนี้


onlyOnWeekday(day)

กําหนดค่ากฎให้นําไปใช้กับวันใดวันหนึ่งของสัปดาห์เท่านั้น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dayWeekdayวันของสัปดาห์

ไปกลับ

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 — กฎการเกิดซ้ําสําหรับเชนนี้


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 — กฎการเกิดซ้ําสําหรับเชนนี้


onlyOnYearDay(day)

กําหนดค่ากฎเพื่อให้นําไปใช้กับวันใดวันหนึ่งของปีเท่านั้น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dayIntegerวันของปี

ไปกลับ

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 — กฎการเกิดซ้ําสําหรับเชนนี้


setTimeZone(timeZone)

ตั้งค่าเขตเวลาสําหรับการเกิดซ้ํานี้ การดําเนินการนี้จะส่งผลต่อวันที่และเวลาที่กิจกรรมเกิดซ้ํา และกิจกรรมมีการเปลี่ยนแปลงตามเวลาออมแสงหรือไม่ ค่าเริ่มต้นคือเขตเวลาของปฏิทิน

พารามิเตอร์

ชื่อประเภทคำอธิบาย
timeZoneStringเขตเวลาที่ระบุ &&tt;long" รูปแบบ (เช่น 'อเมริกา/นิว_ยอร์ก' ตามที่ระบุไว้โดย 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 — กฎการเกิดซ้ําสําหรับเชนนี้


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 — กฎการเกิดซ้ําสําหรับเชนนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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 — กฎการเกิดซ้ําสําหรับเชนนี้