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 - سازنده، برای زنجیر کردن.