Class 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 — this EventRecurrence for chaining

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

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

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

addDateExclusion(date)

เพิ่มกฎที่ยกเว้นการเกิดของเหตุการณ์สำหรับวันที่ที่เจาะจง

พารามิเตอร์

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

รีเทิร์น

EventRecurrence — this EventRecurrence for chaining

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

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

onlyInMonth(month)

กําหนดค่ากฎให้ใช้กับเดือนที่เฉพาะเจาะจงเท่านั้น 

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

พารามิเตอร์

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

รีเทิร์น

RecurrenceRule — 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 — 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 — 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 — RecurrenceRule นี้สําหรับการต่อเชื่อม

onlyOnWeek(week)

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

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

พารามิเตอร์

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

รีเทิร์น

RecurrenceRule — RecurrenceRule นี้สําหรับการต่อเชื่อม

onlyOnWeekday(day)

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

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

พารามิเตอร์

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

รีเทิร์น

RecurrenceRule — 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 — 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 — 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 — 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 — RecurrenceRule นี้สําหรับการต่อเชื่อม

setTimeZone(timeZone)

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
timeZoneStringเขตเวลาซึ่งระบุในรูปแบบ "แบบยาว" (เช่น 'America/New_York' ตามข้อมูลของ Joda.org)

รีเทิร์น

EventRecurrence — this EventRecurrence for chaining

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

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