این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class ClockTriggerBuilder

سازنده برای تریگرهای ساعت.

روش ها

روش	نوع برگشت	شرح مختصر
`after(durationMilliseconds)`	`Clock Trigger Builder`	حداقل مدت زمان (بر حسب میلی ثانیه) را پس از زمان فعلی که ماشه اجرا می کند، مشخص می کند.
`at(date)`	`Clock Trigger Builder`	مشخص می کند که ماشه چه زمانی اجرا شود.
`at Date(year, month, day)`	`Clock Trigger Builder`	مشخص می کند که ماشه در تاریخ معین، به طور پیش فرض نزدیک نیمه شب (+/- 15 دقیقه) فعال می شود.
`at Hour(hour)`	`Clock Trigger Builder`	ساعتی را مشخص می کند که ماشه در آن تریگر اجرا می شود.
`create()`	`Trigger`	ماشه را ایجاد می کند.
`every Days(n)`	`Clock Trigger Builder`	مشخص می کند که تریگر هر `n` روز یکبار اجرا شود.
`every Hours(n)`	`Clock Trigger Builder`	مشخص می کند که تریگر هر `n` ساعت یکبار اجرا شود.
`every Minutes(n)`	`Clock Trigger Builder`	مشخص می کند که ماشه هر `n` دقیقه یکبار اجرا شود.
`every Weeks(n)`	`Clock Trigger Builder`	مشخص می کند که تریگر هر `n` هفته یکبار اجرا شود.
`in Timezone(timezone)`	`Clock Trigger Builder`	منطقه زمانی را برای تاریخ‌ها/زمان‌های مشخص شده زمانی که تریگر اجرا می‌شود، مشخص می‌کند.
`near Minute(minute)`	`Clock Trigger Builder`	دقیقه ای را که در آن ماشه کار می کند (به اضافه یا منهای 15 دقیقه) مشخص می کند.
`on Month Day(day)`	`Clock Trigger Builder`	تاریخ در ماه اجرا شدن تریگر را مشخص می کند.
`on Week Day(day)`	`Clock Trigger Builder`	روزی از هفته را مشخص می کند که ماشه اجرا می شود.

مستندات دقیق

`after(durationMilliseconds)`

حداقل مدت زمان (بر حسب میلی ثانیه) را پس از زمان فعلی که ماشه اجرا می کند، مشخص می کند. مدت زمان واقعی ممکن است متفاوت باشد، اما کمتر از حداقل تعیین شده شما نخواهد بود.

// Creates a trigger that runs 10 minutes later
ScriptApp.newTrigger('myFunction').timeBased().after(10 * 60 * 1000).create();

پارامترها

نام	تایپ کنید	توضیحات
`duration Milliseconds`	`Integer`	حداقل مدت زمان (بر حسب میلی ثانیه) پس از زمان فعلی که ماشه باید اجرا شود.

بازگشت

Clock Trigger Builder - سازنده، برای زنجیر کردن.

`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`	یک شیء تاریخ که نشان دهنده زمانی است که تریگر باید اجرا شود.

بازگشت

Clock Trigger Builder - سازنده، برای زنجیر کردن.

`at Date(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 باشد).

بازگشت

Clock Trigger Builder - سازنده، برای زنجیر کردن.

`at Hour(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`	ساعتی که در آن شلیک شود.

بازگشت

Clock Trigger Builder - سازنده، برای زنجیر کردن.

`create()`

ماشه را ایجاد می کند.

بازگشت

Trigger - ماشه تازه ایجاد شده و برنامه ریزی شده.

`every Days(n)`

مشخص می کند که تریگر هر n روز یکبار اجرا شود.

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

پارامترها

نام	تایپ کنید	توضیحات
`n`	`Integer`	تعداد روزهای بین اعدام.

بازگشت

Clock Trigger Builder - سازنده، برای زنجیر کردن.

`every Hours(n)`

مشخص می کند که تریگر هر n ساعت یکبار اجرا شود.

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

پارامترها

نام	تایپ کنید	توضیحات
`n`	`Integer`	تعداد ساعات بین اعدام.

بازگشت

Clock Trigger Builder - سازنده، برای زنجیر کردن.

`every Minutes(n)`

مشخص می کند که ماشه هر n دقیقه یکبار اجرا شود. n باید 1، 5، 10، 15 یا 30 باشد.

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

پارامترها

نام	تایپ کنید	توضیحات
`n`	`Integer`	تعداد دقیقه بین اعدام ها.

بازگشت

Clock Trigger Builder - سازنده، برای زنجیر کردن.

`every Weeks(n)`

مشخص می کند که تریگر هر n هفته یکبار اجرا شود.

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

پارامترها

نام	تایپ کنید	توضیحات
`n`	`Integer`	تعداد هفته های بین اعدام.

بازگشت

Clock Trigger Builder - سازنده، برای زنجیر کردن.

`in Timezone(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`	منطقه زمانی که با آن اطلاعات زمانی در رویداد مورد بررسی قرار می گیرد.

بازگشت

Clock Trigger Builder - این Clock Trigger Builder ، برای زنجیر کردن.

`near Minute(minute)`

دقیقه ای را که در آن ماشه کار می کند (به اضافه یا منهای 15 دقیقه) مشخص می کند. اگر near Minute() فراخوانی نشود، یک مقدار دقیقه تصادفی استفاده می شود.

// 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`	دقیقه ای که باید شلیک کرد.

بازگشت

Clock Trigger Builder - سازنده، برای زنجیر کردن.

`on Month Day(day)`

تاریخ در ماه اجرا شدن تریگر را مشخص می کند.

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

پارامترها

نام	تایپ کنید	توضیحات
`day`	`Integer`	روزی از ماه که ماشه آن باید برای آن برنامه ریزی شود.

بازگشت

Clock Trigger Builder - سازنده، برای زنجیر کردن.

`on Week Day(day)`

روزی از هفته را مشخص می کند که ماشه اجرا می شود.

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

پارامترها

نام	تایپ کنید	توضیحات
`day`	`Weekday`	روز هفته به آتش.

بازگشت

Clock Trigger Builder - سازنده، برای زنجیر کردن.