Class EventRecurrence

เหตุการณ์ความถี่

แสดงการตั้งค่าการเกิดซ้ำของชุดเหตุการณ์

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
addDailyExclusion()RecurrenceRuleเพิ่มกฎที่ยกเว้นเหตุการณ์ที่เกิดขึ้นในแต่ละวัน
addDailyRule()RecurrenceRuleเพิ่มกฎที่ทำให้เหตุการณ์เกิดขึ้นซ้ำทุกวัน
addDate(date)EventRecurrenceเพิ่มกฎที่ทำให้เหตุการณ์เกิดขึ้นซ้ำในวันที่ที่ระบุ
addDateExclusion(date)EventRecurrenceเพิ่มกฎที่ยกเว้นการเกิดของเหตุการณ์สำหรับวันที่ที่เจาะจง
addMonthlyExclusion()RecurrenceRuleเพิ่มกฎที่ยกเว้นเหตุการณ์ที่เกิดขึ้นเป็นรายเดือน
addMonthlyRule()RecurrenceRuleเพิ่มกฎที่ทำให้กิจกรรมเกิดขึ้นซ้ำทุกเดือน
addWeeklyExclusion()RecurrenceRuleเพิ่มกฎที่ยกเว้นเหตุการณ์ที่เกิดขึ้นเป็นรายสัปดาห์
addWeeklyRule()RecurrenceRuleเพิ่มกฎที่ทำให้กิจกรรมเกิดขึ้นซ้ำทุกสัปดาห์
addYearlyExclusion()RecurrenceRuleเพิ่มกฎที่ยกเว้นเหตุการณ์ที่เกิดขึ้นเป็นประจำทุกปี
addYearlyRule()RecurrenceRuleเพิ่มกฎที่ทำให้เหตุการณ์เกิดขึ้นซ้ำทุกปี
setTimeZone(timeZone)EventRecurrenceตั้งค่าเขตเวลาสำหรับการเกิดซ้ำนี้

เอกสารประกอบโดยละเอียด

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()

เพิ่มกฎที่ยกเว้นเหตุการณ์ที่เกิดขึ้นเป็นรายเดือน

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

รีเทิร์น

RecurrenceRule — RecurrenceRule ใหม่

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

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

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

addMonthlyRule()

เพิ่มกฎที่ทำให้กิจกรรมเกิดขึ้นซ้ำทุกเดือน

โดยค่าเริ่มต้น เหตุการณ์จะซ้ำในวันเดียวกันของเดือนกับเหตุการณ์แรกในชุด แต่สามารถเปลี่ยนแปลงได้โดยเรียกใช้ RecurrenceRule.onlyOnMonthDay(day) หรือ RecurrenceRule.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()

เพิ่มกฎที่ยกเว้นเหตุการณ์ที่เกิดขึ้นเป็นรายสัปดาห์

โดยค่าเริ่มต้น ระบบจะใช้การยกเว้นในวันเดียวกันของสัปดาห์กับกิจกรรมแรกในชุด แต่สามารถเปลี่ยนแปลงได้โดยเรียกใช้ RecurrenceRule.onlyOnWeekday(day) หรือ RecurrenceRule.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()

เพิ่มกฎที่ทำให้กิจกรรมเกิดขึ้นซ้ำทุกสัปดาห์

โดยค่าเริ่มต้น กิจกรรมจะซ้ำในวันเดียวกันของสัปดาห์กับกิจกรรมแรกในชุด แต่สามารถเปลี่ยนแปลงได้โดยเรียกใช้ RecurrenceRule.onlyOnWeekday(day) หรือ RecurrenceRule.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()

เพิ่มกฎที่ยกเว้นเหตุการณ์ที่เกิดขึ้นเป็นประจำทุกปี

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

รีเทิร์น

RecurrenceRule — RecurrenceRule ใหม่

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

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

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

addYearlyRule()

เพิ่มกฎที่ทำให้เหตุการณ์เกิดขึ้นซ้ำทุกปี

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

รีเทิร์น

RecurrenceRule — RecurrenceRule ใหม่

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

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

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

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