หน้านี้ได้รับการแปลโดย Cloud Translation API

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

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

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

`addDate(date)`

เพิ่มกฎที่ทำให้กิจกรรมเกิดซ้ำในวันที่ที่ระบุ

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`date`	`Date`

รีเทิร์น

EventRecurrence — EventRecurrence นี้สำหรับเชน

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

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

`addDateExclusion(date)`

เพิ่มกฎที่ยกเว้นรายการสำหรับวันที่ที่ระบุ

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`date`	`Date`

รีเทิร์น

EventRecurrence — EventRecurrence นี้สำหรับเชน

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

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

`addMonthlyExclusion()`

เพิ่มกฎที่ยกเว้นรายการเป็นรายเดือน

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

รีเทิร์น

RecurrenceRule — กฎการเกิดซ้ำใหม่

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

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

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

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

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

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

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

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

`addYearlyExclusion()`

เพิ่มกฎที่ยกเว้นรายการทุกปี

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

รีเทิร์น

RecurrenceRule — กฎการเกิดซ้ำใหม่

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

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

`addYearlyRule()`

เพิ่มกฎที่ทำให้กิจกรรมเกิดซ้ำทุกปี

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

รีเทิร์น

RecurrenceRule — กฎการเกิดซ้ำใหม่

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`interval`	`Integer`	ช่วงเวลาในหน่วยเวลาของกฎ

รีเทิร์น

RecurrenceRule — RecurrenceRule นี้สำหรับเชน

`onlyInMonth(month)`

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`month`	`Month`	เดือน

รีเทิร์น

RecurrenceRule — 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]);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`months`	`Month[]`	เดือน

รีเทิร์น

RecurrenceRule — RecurrenceRule นี้สำหรับเชน

`onlyOnMonthDay(day)`

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

// Creates a rule that recurs every month on the fifth day of the month.
var recurrence = CalendarApp.newRecurrence().addMonthlyRule().onlyOnMonthDay(5);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`day`	`Integer`	วันของเดือน

รีเทิร์น

RecurrenceRule — 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]);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`days`	`Integer[]`	วันของเดือน

รีเทิร์น

RecurrenceRule — RecurrenceRule นี้สำหรับเชน

`onlyOnWeek(week)`

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`week`	`Integer`	สัปดาห์

รีเทิร์น

RecurrenceRule — RecurrenceRule นี้สำหรับเชน

`onlyOnWeekday(day)`

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`day`	`Weekday`	วันของสัปดาห์

รีเทิร์น

RecurrenceRule — 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]);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`days`	`Weekday[]`	วันของสัปดาห์

รีเทิร์น

RecurrenceRule — 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]);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`weeks`	`Integer[]`	สัปดาห์

รีเทิร์น

RecurrenceRule — RecurrenceRule นี้สำหรับเชน

`onlyOnYearDay(day)`

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`day`	`Integer`	วันของปี

รีเทิร์น

RecurrenceRule — RecurrenceRule นี้สำหรับเชน

`onlyOnYearDays(days)`

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`days`	`Integer[]`	วันของปี

รีเทิร์น

RecurrenceRule — RecurrenceRule นี้สำหรับเชน

`setTimeZone(timeZone)`

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`timeZone`	`String`	เขตเวลาที่ระบุในรูปแบบ "ยาว" (เช่น "America/New_York" ตามที่แสดงใน Joda.org)

รีเทิร์น

EventRecurrence — EventRecurrence นี้สำหรับเชน

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`times`	`Integer`	จำนวนครั้งที่เกิดซ้ำ

รีเทิร์น

RecurrenceRule — 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'));

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`endDate`	`Date`

รีเทิร์น

RecurrenceRule — RecurrenceRule นี้สำหรับเชน

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`day`	`Weekday`	วันที่เริ่มสัปดาห์

รีเทิร์น

RecurrenceRule — RecurrenceRule นี้สำหรับเชน