Class RecurrenceRule

RecurrenceRule

แสดงกฎการเกิดซ้ำสำหรับชุดกิจกรรม

โปรดทราบว่าคลาสนี้ยังทำงานเหมือนกับ EventRecurrence ที่เป็นของคลาส ซึ่งช่วยให้คุณสร้างกฎแบบลูกโซ่ได้ดังนี้ 

const recurrence = CalendarApp.newRecurrence().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.
const 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.
const 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.
const 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.
const 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.
const 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.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().interval(4);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
intervalIntegerช่วงเวลาในหน่วยเวลาของกฎ

รีเทิร์น

RecurrenceRule - กฎการเกิดซ้ำนี้สำหรับการเชื่อมโยง

onlyInMonth(month)

กำหนดค่ากฎให้มีผลเฉพาะในเดือนที่ระบุ 

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

พารามิเตอร์

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

รีเทิร์น

RecurrenceRule - กฎการเกิดซ้ำนี้สำหรับการเชื่อมโยง

onlyInMonths(months)

กำหนดค่ากฎให้มีผลกับเดือนที่เฉพาะเจาะจงเท่านั้น 

// Creates a rule that recurs every week in February and March.
const 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.
const 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.
const recurrence =
    CalendarApp.newRecurrence().addMonthlyRule().onlyOnMonthDays([1, 15]);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
daysInteger[]วันของเดือน

รีเทิร์น

RecurrenceRule - กฎการเกิดซ้ำนี้สำหรับการเชื่อมโยง

onlyOnWeek(week)

กำหนดค่ากฎให้มีผลเฉพาะสัปดาห์ที่เฉพาะเจาะจงของปี 

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

พารามิเตอร์

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

รีเทิร์น

RecurrenceRule - กฎการเกิดซ้ำนี้สำหรับการเชื่อมโยง

onlyOnWeekday(day)

กำหนดค่ากฎให้มีผลเฉพาะกับวันใดวันหนึ่งในสัปดาห์ 

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

พารามิเตอร์

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

รีเทิร์น

RecurrenceRule - กฎการเกิดซ้ำนี้สำหรับการเชื่อมโยง

onlyOnWeekdays(days)

กำหนดค่ากฎให้มีผลเฉพาะในบางวันของสัปดาห์ 

// Creates a rule that recurs every week on Tuesdays and Thursdays.
const 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.
const recurrence =
    CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeeks([5, 10]);

พารามิเตอร์

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

รีเทิร์น

RecurrenceRule - กฎการเกิดซ้ำนี้สำหรับการเชื่อมโยง

onlyOnYearDay(day)

กำหนดค่ากฎให้มีผลเฉพาะในวันใดวันหนึ่งของปี 

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

พารามิเตอร์

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

รีเทิร์น

RecurrenceRule - กฎการเกิดซ้ำนี้สำหรับการเชื่อมโยง

onlyOnYearDays(days)

กำหนดค่ากฎให้ใช้กับบางวันของปีเท่านั้น 

// Creates a rule that recurs every year on January 20 and February 15.
const recurrence =
    CalendarApp.newRecurrence().addYearlyRule().onlyOnYearDay([20, 46]);

พารามิเตอร์

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

รีเทิร์น

RecurrenceRule - กฎการเกิดซ้ำนี้สำหรับการเชื่อมโยง

setTimeZone(timeZone)

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
timeZoneStringเขตเวลาที่ระบุในรูปแบบ "ยาว" (เช่น "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.
const recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
timesIntegerจำนวนครั้งที่จะเกิดซ้ำ

รีเทิร์น

RecurrenceRule - กฎการเกิดซ้ำนี้สำหรับการเชื่อมโยง

until(endDate)

กำหนดค่ากฎให้สิ้นสุดในวันที่ที่ระบุ (รวมวันที่ที่ระบุ) 

// Creates a rule that recurs every day through the end of 2013.
const 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.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().weekStartsOn(
    CalendarApp.Weekday.MONDAY);

พารามิเตอร์

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

รีเทิร์น

RecurrenceRule - กฎการเกิดซ้ำนี้สำหรับการเชื่อมโยง