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
const triggerDay = new Date(2012, 11, 1);
ScriptApp.newTrigger('myFunction').timeBased().at(triggerDay).create();

المعلمات

الاسم	النوع	الوصف
date	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: أداة الإنشاء، لتسلسل العمليات