Class ClockTriggerBuilder

ClockTriggerBuilder

منصة لإنشاء مشغلات الساعة.

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
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();

المعلمات

الاسم	النوع	الوصف
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();

المعلمات

الاسم	النوع	الوصف
date	Date	عنصر تاريخ يمثل وقت تشغيل المشغل.

الإرجاع

ClockTriggerBuilder — أداة الإنشاء للسلاسل

---

atDate(year, month, day)

للإشارة إلى أنّه يتم تنشيط المشغِّل في التاريخ المحدّد، تلقائيًا بالقرب من منتصف الليل (15 دقيقة +/-).

// Schedules for January 1st, 2013
ScriptApp.newTrigger("myFunction")
  .timeBased()
  .atDate(2013, 1, 1)
  .create();

المعلمات

الاسم	النوع	الوصف
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();

المعلمات

الاسم	النوع	الوصف
hour	Integer	الساعة التي يتم تنشيطها.

الإرجاع

ClockTriggerBuilder — أداة الإنشاء للسلاسل

---

create()

ينشئ العامل المشغِّل.

الإرجاع

Trigger — عامل التفعيل المُجدوَل الذي تم إنشاؤه حديثًا

---

everyDays(n)

يحدد هذا الخيار تنفيذ عامل التفعيل كل n يوم.

ScriptApp.newTrigger("myFunction")
  .timeBased()
  .everyDays(3)
  .create();

المعلمات

الاسم	النوع	الوصف
n	Integer	عدد الأيام بين عمليات التنفيذ.

الإرجاع

ClockTriggerBuilder — أداة الإنشاء للسلاسل

---

everyHours(n)

يتم تحديد هذه السمة لتشغيل المشغّل كل n ساعة.

ScriptApp.newTrigger("myFunction")
  .timeBased()
  .everyHours(12)
  .create();

المعلمات

الاسم	النوع	الوصف
n	Integer	عدد الساعات بين عمليات التنفيذ.

الإرجاع

ClockTriggerBuilder — أداة الإنشاء للسلاسل

---

everyMinutes(n)

يتم تحديد هذه السمة لتشغيل المشغّل كل n دقيقة. يجب أن تكون قيمة n 1 أو 5 أو 10 أو 15 أو 30.

ScriptApp.newTrigger("myFunction")
  .timeBased()
  .everyMinutes(10)
  .create();

المعلمات

الاسم	النوع	الوصف
n	Integer	عدد الدقائق بين عمليات التنفيذ

الإرجاع

ClockTriggerBuilder — أداة الإنشاء للسلاسل

---

everyWeeks(n)

يحدد هذا الخيار تنفيذ عامل التفعيل كل n أسبوع.

ScriptApp.newTrigger("myFunction")
  .timeBased()
  .everyWeeks(2)
  .onWeekDay(ScriptApp.WeekDay.FRIDAY)
  .create();

المعلمات

الاسم	النوع	الوصف
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();

المعلمات

الاسم	النوع	الوصف
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();

المعلمات

الاسم	النوع	الوصف
minute	Integer	الدقيقة التي يتم إطلاق النار فيها

الإرجاع

ClockTriggerBuilder — أداة الإنشاء للسلاسل

---

onMonthDay(day)

تحدِّد هذه السياسة تاريخ الشهر الذي يتم فيه تشغيل المشغِّل.

// Schedules for the first of every month
ScriptApp.newTrigger("myFunction")
  .timeBased()
  .onMonthDay(1)
  .create();

المعلمات

الاسم	النوع	الوصف
day	Integer	اليوم من الشهر الذي يجب جدولة المشغّل فيه.

الإرجاع

ClockTriggerBuilder — أداة الإنشاء للسلاسل

---

onWeekDay(day)

تحدد اليوم من الأسبوع الذي يتم فيه تشغيل العامل المشغِّل.

ScriptApp.newTrigger("myFunction")
  .timeBased()
  .onWeekDay(ScriptApp.WeekDay.FRIDAY)
  .create();

المعلمات

الاسم	النوع	الوصف
day	Weekday	يوم من الأسبوع لتنشيطه.

الإرجاع

ClockTriggerBuilder — أداة الإنشاء للسلاسل