أداة إنشاء لمشغلات الساعة.
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
after(durationMilliseconds) | ClockTriggerBuilder | تحدّد هذه العلامة الحد الأدنى للمدة (بالمللي ثانية) بعد الوقت الحالي الذي يتم فيه تشغيل المشغِّل. |
at(date) | ClockTriggerBuilder | تُحدِّد هذه السياسة وقت تشغيل المشغِّل. |
atDate(year, month, day) | ClockTriggerBuilder | تحدّد هذه السياسة أنّه يتم تنشيط المشغِّل في التاريخ المحدَّد، بشكلٍ تلقائي بالقرب من منتصف الليل (+/- 15 دقيقة). |
atHour(hour) | ClockTriggerBuilder | يحدِّد الساعة التي يتم فيها تشغيل المشغِّل. |
create() | Trigger | ينشئ العامل المشغِّل. |
everyDays(n) | ClockTriggerBuilder | يتم تحديده لتشغيل عامل التفعيل كل n يوم. |
everyHours(n) | ClockTriggerBuilder | يتم تحديده لتشغيل عامل التفعيل كل n ساعة. |
everyMinutes(n) | ClockTriggerBuilder | يتم تحديده لتشغيل المشغِّل كل n دقيقة. |
everyWeeks(n) | ClockTriggerBuilder | يتم تحديده لتشغيل عامل التفعيل كل n أسبوع. |
inTimezone(timezone) | ClockTriggerBuilder | تحدّد المنطقة الزمنية للتواريخ/الوقت المحدّدة عند تشغيل المشغِّل. |
nearMinute(minute) | ClockTriggerBuilder | تحدد الدقيقة التي يتم فيها تشغيل المشغِّل (بالإضافة إلى 15 دقيقة أو ناقصها). |
onMonthDay(day) | ClockTriggerBuilder | تحدّد التاريخ في الشهر الذي يتم فيه تشغيل العامل المشغِّل. |
onWeekDay(day) | ClockTriggerBuilder | يحدِّد يوم الأسبوع الذي يتم فيه تشغيل العامل المشغِّل. |
الوثائق التفصيلية
after(durationMilliseconds)
تحدّد هذه العلامة الحد الأدنى للمدة (بالمللي ثانية) بعد الوقت الحالي الذي يتم فيه تشغيل المشغِّل. قد تختلف المدة الفعلية، ولكنها لن تكون أقل من الحد الأدنى المحدَّد.
// Creates a trigger that runs 10 minutes later ScriptApp.newTrigger("myFunction") .timeBased() .after(10 * 60 * 1000) .create();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
durationMilliseconds | Integer | تمثّل هذه السمة الحد الأدنى للمدة (بالمللي ثانية) بعد الوقت الحالي الذي يجب فيه تشغيل المشغِّل. |
استرجاع الكرة
ClockTriggerBuilder
— أداة إنشاء السلاسل
at(date)
تُحدِّد هذه السياسة وقت تشغيل المشغِّل.
// Creates a trigger for December 1, 2012 var triggerDay = new Date(2012, 11, 1); ScriptApp.newTrigger("myFunction") .timeBased() .at(triggerDay) .create();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
date | Date | يشير ذلك المصطلح إلى كائن "تاريخ" يمثّل وقت تشغيل المشغّل. |
استرجاع الكرة
ClockTriggerBuilder
— أداة إنشاء السلاسل
atDate(year, month, day)
تحدّد هذه السياسة أنّه يتم تنشيط المشغِّل في التاريخ المحدَّد، بشكلٍ تلقائي بالقرب من منتصف الليل (+/- 15 دقيقة).
// Schedules for January 1st, 2013 ScriptApp.newTrigger("myFunction") .timeBased() .atDate(2013, 1, 1) .create();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
year | Integer | السنة التقويمية لجدولة العامل المشغِّل. |
month | Integer | الشهر التقويمي لجدولة العامل المشغِّل (يجب أن يكون رقمًا يتراوح بين 1 و12، بشكل شامل). |
day | Integer | اليوم التقويمي لجدولة العامل المشغِّل (يجب أن يكون رقمًا يتراوح بين 1 و31، بشكل شامل). |
استرجاع الكرة
ClockTriggerBuilder
— أداة إنشاء السلاسل
atHour(hour)
يحدِّد الساعة التي يتم فيها تشغيل المشغِّل.
// Runs between 5am-6am in the timezone of the script ScriptApp.newTrigger("myFunction") .timeBased() .atHour(5) .everyDays(1) // Frequency is required if you are using atHour() or nearMinute() .create();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
hour | Integer | الساعة التي ينطلق فيها النشاط. |
استرجاع الكرة
ClockTriggerBuilder
— أداة إنشاء السلاسل
create()
everyDays(n)
يتم تحديده لتشغيل عامل التفعيل كل n
يوم.
ScriptApp.newTrigger("myFunction") .timeBased() .everyDays(3) .create();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
n | Integer | عدد الأيام بين عمليات التنفيذ. |
استرجاع الكرة
ClockTriggerBuilder
— أداة إنشاء السلاسل
everyHours(n)
يتم تحديده لتشغيل عامل التفعيل كل n
ساعة.
ScriptApp.newTrigger("myFunction") .timeBased() .everyHours(12) .create();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
n | Integer | عدد الساعات بين عمليات التنفيذ. |
استرجاع الكرة
ClockTriggerBuilder
— أداة إنشاء السلاسل
everyMinutes(n)
يتم تحديده لتشغيل المشغِّل كل n
دقيقة. يجب أن تكون قيمة السمة n
1 أو 5 أو 10 أو 15 أو 30.
ScriptApp.newTrigger("myFunction") .timeBased() .everyMinutes(10) .create();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
n | Integer | عدد الدقائق بين عمليات التنفيذ. |
استرجاع الكرة
ClockTriggerBuilder
— أداة إنشاء السلاسل
everyWeeks(n)
يتم تحديده لتشغيل عامل التفعيل كل n
أسبوع.
ScriptApp.newTrigger("myFunction") .timeBased() .everyWeeks(2) .onWeekDay(ScriptApp.WeekDay.FRIDAY) .create();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
n | Integer | عدد الأسابيع بين عمليات التنفيذ. |
استرجاع الكرة
ClockTriggerBuilder
— أداة إنشاء السلاسل
inTimezone(timezone)
تحدّد المنطقة الزمنية للتواريخ/الوقت المحدّدة عند تشغيل المشغِّل. بشكل افتراضي، تكون المنطقة الزمنية هي منطقة النص البرمجي.
تتوافق قائمة سلاسل المناطق الزمنية الصالحة مع سلاسل المناطق الزمنية الصالحة الواردة من Joda.org. تؤدي سلسلة المنطقة الزمنية غير الصالحة إلى عرض النص البرمجي للخطأ.
// Schedule the trigger to execute at noon every day in the US/Pacific time zone ScriptApp.newTrigger("myFunction") .timeBased() .atHour(12) .everyDays(1) .inTimezone("America/Los_Angeles") .create();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
timezone | String | المنطقة الزمنية التي يتم بها معالجة معلومات الوقت في الحدث. |
استرجاع الكرة
ClockTriggerBuilder
- جهاز ClockTriggerBuilder
هذا للسلاسل
nearMinute(minute)
تحدد الدقيقة التي يتم فيها تشغيل المشغِّل (بالإضافة إلى 15 دقيقة أو ناقصها). إذا لم يتم استدعاء nearMinute()
، يتم استخدام قيمة دقيقة عشوائية.
// Runs at approximately 5:30am in the timezone of the script ScriptApp.newTrigger("myFunction") .timeBased() .atHour(5) .nearMinute(30) .everyDays(1) // Frequency is required if you are using atHour() or nearMinute() .create();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
minute | Integer | الدقيقة التي تنطلق عندها. |
استرجاع الكرة
ClockTriggerBuilder
— أداة إنشاء السلاسل
onMonthDay(day)
تحدّد التاريخ في الشهر الذي يتم فيه تشغيل العامل المشغِّل.
// Schedules for the first of every month ScriptApp.newTrigger("myFunction") .timeBased() .onMonthDay(1) .create();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
day | Integer | اليوم من الشهر الذي يجب تحديد موعد عامل التشغيل فيه. |
استرجاع الكرة
ClockTriggerBuilder
— أداة إنشاء السلاسل
onWeekDay(day)
يحدِّد يوم الأسبوع الذي يتم فيه تشغيل العامل المشغِّل.
ScriptApp.newTrigger("myFunction") .timeBased() .onWeekDay(ScriptApp.WeekDay.FRIDAY) .create();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
day | Weekday | اليوم الذي ينطلق فيه النشاط من الأسبوع |
استرجاع الكرة
ClockTriggerBuilder
— أداة إنشاء السلاسل