แสดงกฎการเกิดซ้ําของชุดกิจกรรม
โปรดทราบว่าชั้นเรียนนี้ยังมีลักษณะการทํางานเหมือน 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)
เพิ่มกฎที่ทําให้กิจกรรมเกิดซ้ําในวันที่ที่ระบุ
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
date | Date |
ไปกลับ
EventRecurrence
— EventRecurrence สําหรับเชนธุรกิจ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ หรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addDateExclusion(date)
เพิ่มกฎที่ยกเว้นรายการในวันที่ที่ระบุ
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
date | Date |
ไปกลับ
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
interval | Integer | ช่วงเวลาในหน่วยเวลาของกฎ |
ไปกลับ
RecurrenceRule
— กฎการเกิดซ้ําสําหรับเชนนี้
onlyInMonth(month)
กําหนดค่ากฎเพื่อให้นําไปใช้กับเดือนที่ต้องการเท่านั้น
// Creates a rule that recurs every week in February. var recurrence = CalendarApp.newRecurrence() .addWeeklyRule().onlyInMonth(CalendarApp.Month.FEBRUARY);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
month | Month | เดือน |
ไปกลับ
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]);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
months | Month[] | เดือน |
ไปกลับ
RecurrenceRule
— กฎการเกิดซ้ําสําหรับเชนนี้
onlyOnMonthDay(day)
กําหนดค่ากฎให้มีผลกับวันของเดือนเท่านั้น
// Creates a rule that recurs every month on the fifth day of the month. var recurrence = CalendarApp.newRecurrence().addMonthlyRule().onlyOnMonthDay(5);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
day | Integer | วันของเดือน |
ไปกลับ
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]);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
days | Integer[] | วันของเดือน |
ไปกลับ
RecurrenceRule
— กฎการเกิดซ้ําสําหรับเชนนี้
onlyOnWeek(week)
กําหนดค่ากฎให้นําไปใช้กับสัปดาห์ของปีที่ต้องการเท่านั้น
// Creates a rule that recurs on the fifth week of every year. var recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeek(5);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
week | Integer | สัปดาห์ |
ไปกลับ
RecurrenceRule
— กฎการเกิดซ้ําสําหรับเชนนี้
onlyOnWeekday(day)
กําหนดค่ากฎให้นําไปใช้กับวันใดวันหนึ่งของสัปดาห์เท่านั้น
// Creates a rule that recurs every week on Wednesdays. var recurrence = CalendarApp.newRecurrence() .addWeeklyRule().onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
day | Weekday | วันของสัปดาห์ |
ไปกลับ
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]);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
days | Weekday[] | วันของสัปดาห์ |
ไปกลับ
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]);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
weeks | Integer[] | สัปดาห์ |
ไปกลับ
RecurrenceRule
— กฎการเกิดซ้ําสําหรับเชนนี้
onlyOnYearDay(day)
กําหนดค่ากฎเพื่อให้นําไปใช้กับวันใดวันหนึ่งของปีเท่านั้น
// Creates a rule that recurs every year on February 15 (the 46th day). var recurrence = CalendarApp.newRecurrence().addYearlyRule().onlyOnYearDay(46);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
day | Integer | วันของปี |
ไปกลับ
RecurrenceRule
— กฎการเกิดซ้ําสําหรับเชนนี้
onlyOnYearDays(days)
กําหนดค่ากฎเพื่อให้มีผลเฉพาะกับวันที่เฉพาะของปี
// Creates a rule that recurs every year on January 20 and February 15. var recurrence = CalendarApp.newRecurrence().addYearlyRule().onlyOnYearDay([20, 46]);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
days | Integer[] | วันของปี |
ไปกลับ
RecurrenceRule
— กฎการเกิดซ้ําสําหรับเชนนี้
setTimeZone(timeZone)
ตั้งค่าเขตเวลาสําหรับการเกิดซ้ํานี้ การดําเนินการนี้จะส่งผลต่อวันที่และเวลาที่กิจกรรมเกิดซ้ํา และกิจกรรมมีการเปลี่ยนแปลงตามเวลาออมแสงหรือไม่ ค่าเริ่มต้นคือเขตเวลาของปฏิทิน
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
timeZone | String | เขตเวลาที่ระบุ &&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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
times | Integer | จํานวนครั้งที่เกิดซ้ํา |
ไปกลับ
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'));
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
endDate | Date |
ไปกลับ
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
day | Weekday | วันเริ่มต้นสัปดาห์ |
ไปกลับ
RecurrenceRule
— กฎการเกิดซ้ําสําหรับเชนนี้