דף זה תורגם על ידי Cloud Translation API.

Class 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 – ה-builder, לשרשורים.

`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 – ה-builder, לשרשורים.

`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 – ה-builder, לשרשורים.

`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 – ה-builder, לשרשורים.

`create()`

יצירת הטריגר.

חזרה

Trigger – הטריגר החדש שנוצר, המתוזמן.

`everyDays(n)`

מציינת להפעיל את הטריגר מדי n ימים.

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

פרמטרים

שם	סוג	תיאור
`n`	`Integer`	מספר הימים בין הפעלות.

חזרה

ClockTriggerBuilder – ה-builder, לשרשורים.

`everyHours(n)`

קובעים להפעיל את הטריגר בכל שעתיים (n).

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

פרמטרים

שם	סוג	תיאור
`n`	`Integer`	מספר השעות בין הפעלות.

חזרה

ClockTriggerBuilder – ה-builder, לשרשורים.

`everyMinutes(n)`

המדיניות הזו מציינת להפעיל את הטריגר בכל n דקות. n חייב להיות בן 1, 5, 10, 15 או 30.

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

פרמטרים

שם	סוג	תיאור
`n`	`Integer`	מספר הדקות בין הפעלות.

חזרה

ClockTriggerBuilder – ה-builder, לשרשורים.

`everyWeeks(n)`

מציינת להפעיל את הטריגר מדי n שבועות.

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

פרמטרים

שם	סוג	תיאור
`n`	`Integer`	מספר השבועות בין הפעלות.

חזרה

ClockTriggerBuilder – ה-builder, לשרשורים.

`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 – ה-builder, לשרשורים.

`onMonthDay(day)`

מציינת את התאריך בחודש שבו הטריגר פועל.

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

פרמטרים

שם	סוג	תיאור
`day`	`Integer`	היום בחודש שבו צריך לתזמן את הטריגר.

חזרה

ClockTriggerBuilder – ה-builder, לשרשורים.

`onWeekDay(day)`

מציין את היום בשבוע שבו הטריגר פועל.

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

פרמטרים

שם	סוג	תיאור
`day`	`Weekday`	היום בשבוע להפעלה.

חזרה

ClockTriggerBuilder – ה-builder, לשרשורים.