כלי ליצירת טריגרים לפי שעון.
Methods
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
after(durationMilliseconds) | Clock | משך הזמן המינימלי (באלפיות השנייה) לאחר השעה הנוכחית שבו הטריגר פועל. |
at(date) | Clock | מתי הטריגר פועל. |
at | Clock | ההגדרה הזו קובעת שהטריגר יופעל בתאריך שצוין, כברירת מחדל בסביבות חצות (+/- 15 דקות). |
at | Clock | השעה שבה הטריגר פועל. |
create() | Trigger | יצירת הטריגר. |
every | Clock | ההגדרה קובעת להפעיל את הטריגר כל n ימים. |
every | Clock | מציין שהטריגר יופעל כל n שעות. |
every | Clock | הטריגר יופעל כל n דקות. |
every | Clock | מציין להפעיל את הטריגר כל n שבועות. |
in | Clock | מציין את אזור הזמן של התאריכים או השעה שצוינו כשהטריגר פועל. |
near | Clock | הדקה שבה הטריגר פועל (פלוס/מינוס 15 דקות). |
on | Clock | מציין את התאריך בחודש שבו הטריגר פועל. |
on | Clock | מציין את היום בשבוע שבו הטריגר פועל. |
מסמכים מפורטים
after(durationMilliseconds)
משך הזמן המינימלי (באלפיות השנייה) לאחר השעה הנוכחית שבו הטריגר פועל. משך הזמן בפועל עשוי להשתנות, אבל הוא לא יהיה קצר יותר מהמשך הזמן המינימלי שציינתם.
// Creates a trigger that runs 10 minutes later ScriptApp.newTrigger('myFunction').timeBased().after(10 * 60 * 1000).create();
פרמטרים
שם | סוג | תיאור |
---|---|---|
duration | Integer | משך הזמן המינימלי (באלפיות השנייה) אחרי השעה הנוכחית שבו הטריגר אמור לפעול. |
חזרה
Clock
– ה-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 | אובייקט Date שמייצג את המועד שבו הטריגר אמור לפעול. |
חזרה
Clock
– ה-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
– ה-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
– ה-builder, לצורך קישור.
create()
every Days(n)
ההגדרה קובעת להפעיל את הטריגר כל n
ימים.
ScriptApp .newTrigger('myFunction').timeBased().everyDays(3).create();
פרמטרים
שם | סוג | תיאור |
---|---|---|
n | Integer | מספר הימים בין ההפעלות. |
חזרה
Clock
– ה-builder, לצורך קישור.
every Hours(n)
מציין שהטריגר יופעל כל n
שעות.
ScriptApp .newTrigger('myFunction').timeBased().everyHours(12).create();
פרמטרים
שם | סוג | תיאור |
---|---|---|
n | Integer | מספר השעות בין ההפעלות. |
חזרה
Clock
– ה-builder, לצורך קישור.
every Minutes(n)
הטריגר יופעל כל n
דקות. הערך של n
חייב להיות 1, 5, 10, 15 או 30.
ScriptApp .newTrigger('myFunction').timeBased().everyMinutes(10).create();
פרמטרים
שם | סוג | תיאור |
---|---|---|
n | Integer | מספר הדקות בין ההפעלות. |
חזרה
Clock
– ה-builder, לצורך קישור.
every Weeks(n)
מציין להפעיל את הטריגר כל n
שבועות.
ScriptApp .newTrigger('myFunction') .timeBased() .everyWeeks(2) .onWeekDay(ScriptApp.WeekDay.FRIDAY) .create();
פרמטרים
שם | סוג | תיאור |
---|---|---|
n | Integer | מספר השבועות בין ההפעלות. |
חזרה
Clock
– ה-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
— השדה Clock
, לצורך קישור.
near Minute(minute)
הדקה שבה הטריגר פועל (פלוס/מינוס 15 דקות). אם לא קוראים לפונקציה near
, המערכת משתמשת בערך אקראי של דקות.
// 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
– ה-builder, לצורך קישור.
on Month Day(day)
מציין את התאריך בחודש שבו הטריגר פועל.
// Schedules for the first of every month ScriptApp.newTrigger('myFunction').timeBased().onMonthDay(1).create();
פרמטרים
שם | סוג | תיאור |
---|---|---|
day | Integer | היום בחודש שבו צריך לתזמן את הטריגר. |
חזרה
Clock
– ה-builder, לצורך קישור.
on Week Day(day)
מציין את היום בשבוע שבו הטריגר פועל.
ScriptApp .newTrigger('myFunction') .timeBased() .onWeekDay(ScriptApp.WeekDay.FRIDAY) .create();
פרמטרים
שם | סוג | תיאור |
---|---|---|
day | Weekday | היום בשבוע שבו הפונקציה מופעלת. |
חזרה
Clock
– ה-builder, לצורך קישור.