Class RecurrenceRule

RecurrenceRule

Biểu thị một quy tắc lặp lại cho một loạt sự kiện.

Xin lưu ý rằng lớp này cũng hoạt động giống như EventRecurrence mà lớp đó thuộc về, cho phép bạn liên kết việc tạo quy tắc với nhau như sau:

const recurrence = CalendarApp.newRecurrence().addDailyRule().times(3).interval(2).addWeeklyExclusion().times(2);
Các đối tượng sửa đổi như times(times)interval(interval) được áp dụng cho quy tắc mới thêm gần đây nhất.

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
addDailyExclusion()RecurrenceRuleThêm một quy tắc loại trừ các lần xuất hiện hằng ngày.
addDailyRule()RecurrenceRuleThêm một quy tắc khiến sự kiện diễn ra hằng ngày.
addDate(date)EventRecurrenceThêm một quy tắc khiến sự kiện lặp lại vào một ngày cụ thể.
addDateExclusion(date)EventRecurrenceThêm một quy tắc loại trừ một lần xuất hiện cho một ngày cụ thể.
addMonthlyExclusion()RecurrenceRuleThêm một quy tắc loại trừ các lần xuất hiện theo tháng.
addMonthlyRule()RecurrenceRuleThêm một quy tắc khiến sự kiện diễn ra định kỳ hằng tháng.
addWeeklyExclusion()RecurrenceRuleThêm quy tắc loại trừ các lần xuất hiện theo tuần.
addWeeklyRule()RecurrenceRuleThêm một quy tắc khiến sự kiện diễn ra định kỳ hằng tuần.
addYearlyExclusion()RecurrenceRuleThêm một quy tắc loại trừ các lần xuất hiện theo năm.
addYearlyRule()RecurrenceRuleThêm một quy tắc khiến sự kiện lặp lại hằng năm.
interval(interval)RecurrenceRuleĐịnh cấu hình quy tắc để chỉ áp dụng ở khoảng thời gian này của đơn vị thời gian của quy tắc.
onlyInMonth(month)RecurrenceRuleĐịnh cấu hình quy tắc để chỉ áp dụng cho một tháng cụ thể.
onlyInMonths(months)RecurrenceRuleĐịnh cấu hình quy tắc để chỉ áp dụng cho các tháng cụ thể.
onlyOnMonthDay(day)RecurrenceRuleĐịnh cấu hình quy tắc để chỉ áp dụng cho một ngày cụ thể trong tháng.
onlyOnMonthDays(days)RecurrenceRuleĐịnh cấu hình quy tắc để chỉ áp dụng cho những ngày cụ thể trong tháng.
onlyOnWeek(week)RecurrenceRuleĐịnh cấu hình quy tắc để chỉ áp dụng cho một tuần cụ thể trong năm.
onlyOnWeekday(day)RecurrenceRuleĐịnh cấu hình quy tắc để chỉ áp dụng cho một ngày cụ thể trong tuần.
onlyOnWeekdays(days)RecurrenceRuleĐịnh cấu hình quy tắc để chỉ áp dụng cho những ngày cụ thể trong tuần.
onlyOnWeeks(weeks)RecurrenceRuleĐịnh cấu hình quy tắc để chỉ áp dụng cho một số tuần cụ thể trong năm.
onlyOnYearDay(day)RecurrenceRuleĐịnh cấu hình quy tắc để chỉ áp dụng cho một ngày cụ thể trong năm.
onlyOnYearDays(days)RecurrenceRuleĐịnh cấu hình quy tắc để chỉ áp dụng cho những ngày cụ thể trong năm.
setTimeZone(timeZone)EventRecurrenceĐặt múi giờ cho sự kiện định kỳ này.
times(times)RecurrenceRuleĐịnh cấu hình quy tắc để kết thúc sau một số lần xuất hiện nhất định.
until(endDate)RecurrenceRuleĐịnh cấu hình quy tắc để kết thúc vào một ngày nhất định (bao gồm cả ngày đó).
weekStartsOn(day)RecurrenceRuleĐịnh cấu hình ngày bắt đầu tuần để áp dụng quy tắc.

Tài liệu chi tiết

addDailyExclusion()

Thêm một quy tắc loại trừ các lần xuất hiện hằng ngày.

// Creates a rule that recurs every week after the first 30 days.
const recurrence =
    CalendarApp.newRecurrence().addWeeklyRule().addDailyExclusion().times(30);

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule mới

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

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

addDailyRule()

Thêm một quy tắc khiến sự kiện diễn ra hằng ngày.

// Creates a rule that recurs every day for ten days.
const recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule mới

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

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

addDate(date)

Thêm một quy tắc khiến sự kiện lặp lại vào một ngày cụ thể.

Tham số

TênLoạiMô tả
dateDate

Cầu thủ trả bóng

EventRecurrence – EventRecurrence này để liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

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

addDateExclusion(date)

Thêm một quy tắc loại trừ một lần xuất hiện cho một ngày cụ thể.

Tham số

TênLoạiMô tả
dateDate

Cầu thủ trả bóng

EventRecurrence – EventRecurrence này để liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

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

addMonthlyExclusion()

Thêm một quy tắc loại trừ các lần xuất hiện theo tháng.

Theo mặc định, quy tắc loại trừ được áp dụng vào cùng ngày trong tháng với sự kiện đầu tiên trong chuỗi, nhưng bạn có thể thay đổi quy tắc này bằng cách gọi onlyOnMonthDay(day) hoặc onlyOnMonthDays(days).

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule mới

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

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

addMonthlyRule()

Thêm một quy tắc khiến sự kiện diễn ra định kỳ hằng tháng.

Theo mặc định, sự kiện sẽ lặp lại vào cùng ngày trong tháng với sự kiện đầu tiên trong chuỗi sự kiện, nhưng bạn có thể thay đổi điều này bằng cách gọi onlyOnMonthDay(day) hoặc onlyOnMonthDays(days).

// Creates a rule that recurs every month for three months.
const recurrence = CalendarApp.newRecurrence().addMonthlyRule().times(4);

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule mới

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

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

addWeeklyExclusion()

Thêm quy tắc loại trừ các lần xuất hiện theo tuần.

Theo mặc định, quy tắc loại trừ được áp dụng vào cùng ngày trong tuần với sự kiện đầu tiên trong chuỗi, nhưng bạn có thể thay đổi quy tắc này bằng cách gọi onlyOnWeekday(day) hoặc 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);

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule mới

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

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

addWeeklyRule()

Thêm một quy tắc khiến sự kiện diễn ra định kỳ hằng tuần.

Theo mặc định, sự kiện sẽ lặp lại vào cùng ngày trong tuần như sự kiện đầu tiên trong chuỗi, nhưng bạn có thể thay đổi điều này bằng cách gọi onlyOnWeekday(day) hoặc onlyOnWeekdays(days).

// Creates a rule that recurs every week for ten weeks.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().times(10);

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule mới

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

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

addYearlyExclusion()

Thêm một quy tắc loại trừ các lần xuất hiện theo năm.

Theo mặc định, quy tắc loại trừ được áp dụng vào cùng ngày trong năm với sự kiện đầu tiên trong chuỗi, nhưng bạn có thể thay đổi quy tắc này bằng cách gọi onlyOnYearDay(day) hoặc onlyOnYearDays(days).

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule mới

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

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

addYearlyRule()

Thêm một quy tắc khiến sự kiện lặp lại hằng năm.

Theo mặc định, sự kiện sẽ lặp lại vào cùng ngày trong năm như sự kiện đầu tiên trong chuỗi, nhưng bạn có thể thay đổi điều này bằng cách gọi onlyOnYearDay(day) hoặc onlyOnYearDays(days).

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule mới

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

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

interval(interval)

Định cấu hình quy tắc để chỉ áp dụng ở khoảng thời gian này của đơn vị thời gian của quy tắc.

// Creates a rule that recurs every fourth week.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().interval(4);

Tham số

TênLoạiMô tả
intervalIntegerkhoảng thời gian theo đơn vị thời gian của quy tắc

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule này để xâu chuỗi


onlyInMonth(month)

Định cấu hình quy tắc để chỉ áp dụng cho một tháng cụ thể.

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

Tham số

TênLoạiMô tả
monthMonththáng

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule này để xâu chuỗi


onlyInMonths(months)

Định cấu hình quy tắc để chỉ áp dụng cho các tháng cụ thể.

// Creates a rule that recurs every week in February and March.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyInMonths(
    [CalendarApp.Month.FEBRUARY, CalendarApp.Month.MARCH]);

Tham số

TênLoạiMô tả
monthsMonth[]các tháng

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule này để xâu chuỗi


onlyOnMonthDay(day)

Định cấu hình quy tắc để chỉ áp dụng cho một ngày cụ thể trong tháng.

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

Tham số

TênLoạiMô tả
dayIntegerngày trong tháng

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule này để xâu chuỗi


onlyOnMonthDays(days)

Định cấu hình quy tắc để chỉ áp dụng cho những ngày cụ thể trong tháng.

// Creates a rule that recurs every month on the first and fifteenth day of the
// month.
const recurrence =
    CalendarApp.newRecurrence().addMonthlyRule().onlyOnMonthDays([1, 15]);

Tham số

TênLoạiMô tả
daysInteger[]các ngày trong tháng

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule này để xâu chuỗi


onlyOnWeek(week)

Định cấu hình quy tắc để chỉ áp dụng cho một tuần cụ thể trong năm.

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

Tham số

TênLoạiMô tả
weekIntegertuần

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule này để xâu chuỗi


onlyOnWeekday(day)

Định cấu hình quy tắc để chỉ áp dụng cho một ngày cụ thể trong tuần.

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

Tham số

TênLoạiMô tả
dayWeekdayngày trong tuần

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule này để xâu chuỗi


onlyOnWeekdays(days)

Định cấu hình quy tắc để chỉ áp dụng cho những ngày cụ thể trong tuần.

// Creates a rule that recurs every week on Tuesdays and Thursdays.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeekdays(
    [CalendarApp.Weekday.TUESDAY, CalendarApp.Weekday.THURSDAY]);

Tham số

TênLoạiMô tả
daysWeekday[]các ngày trong tuần

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule này để xâu chuỗi


onlyOnWeeks(weeks)

Định cấu hình quy tắc để chỉ áp dụng cho một số tuần cụ thể trong năm.

// Creates a rule that recurs on the fifth and tenth weeks of every year.
const recurrence =
    CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeeks([5, 10]);

Tham số

TênLoạiMô tả
weeksInteger[]tuần

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule này để xâu chuỗi


onlyOnYearDay(day)

Định cấu hình quy tắc để chỉ áp dụng cho một ngày cụ thể trong năm.

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

Tham số

TênLoạiMô tả
dayIntegerngày trong năm

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule này để xâu chuỗi


onlyOnYearDays(days)

Định cấu hình quy tắc để chỉ áp dụng cho những ngày cụ thể trong năm.

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

Tham số

TênLoạiMô tả
daysInteger[]các ngày trong năm

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule này để xâu chuỗi


setTimeZone(timeZone)

Đặt múi giờ cho sự kiện định kỳ này. Điều này ảnh hưởng đến ngày và giờ diễn ra các sự kiện định kỳ, cũng như việc sự kiện có thay đổi theo giờ mùa hè hay không. Giá trị mặc định là múi giờ của lịch.

Tham số

TênLoạiMô tả
timeZoneStringmúi giờ, được chỉ định ở định dạng "dài" (ví dụ: "Châu Mỹ/New_York", như được liệt kê bởi Joda.org)

Cầu thủ trả bóng

EventRecurrence – EventRecurrence này để liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

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

times(times)

Định cấu hình quy tắc để kết thúc sau một số lần xuất hiện nhất định.

// Creates a rule that recurs every day for ten days.
const recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

Tham số

TênLoạiMô tả
timesIntegersố lần lặp lại

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule này để xâu chuỗi


until(endDate)

Định cấu hình quy tắc để kết thúc vào một ngày nhất định (bao gồm cả ngày đó).

// Creates a rule that recurs every day through the end of 2013.
const recurrence = CalendarApp.newRecurrence().addDailyRule().until(
    new Date('December 31, 2013'));

Tham số

TênLoạiMô tả
endDateDate

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

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

weekStartsOn(day)

Định cấu hình ngày bắt đầu tuần để áp dụng quy tắc.

// Creates a weekly rule where weeks start on Monday.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().weekStartsOn(
    CalendarApp.Weekday.MONDAY);

Tham số

TênLoạiMô tả
dayWeekdayngày bắt đầu tuần

Cầu thủ trả bóng

RecurrenceRule – RecurrenceRule này để xâu chuỗi