Class RecurrenceRule

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: قاعدة RecurrenceRule الجديدة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

  • 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: قاعدة RecurrenceRule الجديدة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

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

addDate(date)

إضافة قاعدة تؤدي إلى تكرار الحدث في تاريخ محدد

المعلمات

الاسمالنوعالوصف
dateDate

الإرجاع

EventRecurrence — حدث EventRecurrence هذا للتسلسل

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

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

addDateExclusion(date)

إضافة قاعدة تستبعد ورودًا لتاريخ محدد.

المعلمات

الاسمالنوعالوصف
dateDate

الإرجاع

EventRecurrence — حدث EventRecurrence هذا للتسلسل

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

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

addMonthlyExclusion()

إضافة قاعدة تستبعد التكرارات على أساس شهري.

يتم تطبيق الاستثناء تلقائيًا في اليوم نفسه من الشهر الذي يقع فيه الحدث الأول في ولكن يمكن تغيير ذلك من خلال طلب الرقم onlyOnMonthDay(day) أو onlyOnMonthDays(days).

الإرجاع

RecurrenceRule: قاعدة RecurrenceRule الجديدة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

  • 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: قاعدة RecurrenceRule الجديدة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

  • 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: قاعدة RecurrenceRule الجديدة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

  • 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: قاعدة RecurrenceRule الجديدة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

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

addYearlyExclusion()

تضيف قاعدة تستبعد مواضع الورود سنويًا.

يتم تطبيق الاستثناء تلقائيًا في اليوم نفسه من العام الذي يقع فيه الحدث الأول في ولكن يمكن تغيير ذلك من خلال طلب الرقم onlyOnYearDay(day) أو onlyOnYearDays(days).

الإرجاع

RecurrenceRule: قاعدة RecurrenceRule الجديدة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

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

addYearlyRule()

تضيف قاعدة تؤدي إلى تكرار الحدث على أساس سنوي.

بشكل افتراضي، يتكرر الحدث في اليوم نفسه من السنة الذي يقع فيه الحدث الأول في السلسلة، ولكن يمكن تغيير ذلك من خلال طلب الرقم onlyOnYearDay(day) أو onlyOnYearDays(days).

الإرجاع

RecurrenceRule: قاعدة RecurrenceRule الجديدة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

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

المعلمات

الاسمالنوعالوصف
intervalIntegerالفاصل في الوحدة الزمنية للقاعدة

الإرجاع

RecurrenceRule — قاعدة التكرار هذه للتسلسل


onlyInMonth(month)

تحدِّد هذه السياسة القاعدة لتطبيقها على شهر معيّن فقط.

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

المعلمات

الاسمالنوعالوصف
monthMonthالشهر

الإرجاع

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

المعلمات

الاسمالنوعالوصف
monthsMonth[]الأشهر

الإرجاع

RecurrenceRule — قاعدة التكرار هذه للتسلسل


onlyOnMonthDay(day)

تعمل هذه السياسة على ضبط القاعدة بحيث لا يتم تطبيقها إلا على يوم محدَّد من الشهر.

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

المعلمات

الاسمالنوعالوصف
dayIntegerاليوم من الشهر

الإرجاع

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

المعلمات

الاسمالنوعالوصف
daysInteger[]أيام الشهر

الإرجاع

RecurrenceRule — قاعدة التكرار هذه للتسلسل


onlyOnWeek(week)

تحدِّد هذه السياسة القاعدة بحيث لا يتم تطبيقها إلا على أسبوع معيّن من السنة.

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

المعلمات

الاسمالنوعالوصف
weekIntegerالأسبوع

الإرجاع

RecurrenceRule — قاعدة التكرار هذه للتسلسل


onlyOnWeekday(day)

تعمل هذه السياسة على ضبط القاعدة بحيث لا يتم تطبيقها إلا على يوم محدَّد من الأسبوع.

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

المعلمات

الاسمالنوعالوصف
dayWeekdayيوم من الأسبوع

الإرجاع

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

المعلمات

الاسمالنوعالوصف
daysWeekday[]أيام الأسبوع

الإرجاع

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

المعلمات

الاسمالنوعالوصف
weeksInteger[]الأسابيع

الإرجاع

RecurrenceRule — قاعدة التكرار هذه للتسلسل


onlyOnYearDay(day)

تعمل هذه السياسة على ضبط القاعدة بحيث لا يتم تطبيقها إلا على يوم محدَّد من السنة.

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

المعلمات

الاسمالنوعالوصف
dayIntegerيوم من السنة

الإرجاع

RecurrenceRule — قاعدة التكرار هذه للتسلسل


onlyOnYearDays(days)

تعمل هذه السياسة على ضبط القاعدة بحيث لا يتم تطبيقها إلا على أيام محدَّدة من السنة.

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

المعلمات

الاسمالنوعالوصف
daysInteger[]أيام من السنة

الإرجاع

RecurrenceRule — قاعدة التكرار هذه للتسلسل


setTimeZone(timeZone)

يتم تعيين المنطقة الزمنية لهذا التكرار. يؤثر هذا في تاريخ ووقت تكرار الأحداث وما إذا كان الحدث يتغير مع التوقيت الصيفي. يتم ضبط القيمة التلقائية على المنطقة الزمنية للتقويم.

المعلمات

الاسمالنوعالوصف
timeZoneStringالمنطقة الزمنية، محددة بالتنسيق "طويل" (مثلاً، "America/New_York"، كما هو مُدرَج بواسطة Joda.org)

الإرجاع

EventRecurrence — حدث EventRecurrence هذا للتسلسل

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

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

المعلمات

الاسمالنوعالوصف
timesIntegerعدد مرات التكرار

الإرجاع

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

المعلمات

الاسمالنوعالوصف
endDateDate

الإرجاع

RecurrenceRule — قاعدة التكرار هذه للتسلسل

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:

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

المعلمات

الاسمالنوعالوصف
dayWeekdayاليوم الذي يبدأ فيه الأسبوع

الإرجاع

RecurrenceRule — قاعدة التكرار هذه للتسلسل