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

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

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


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 — กฎการเกิดซ้ำนี้สำหรับการทำสายโซ่