เครื่องมือสร้างสำหรับทริกเกอร์นาฬิกา
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
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()
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
— เครื่องมือสร้างสำหรับการทำสายโซ่