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();

พารามิเตอร์

ชื่อTypeคำอธิบาย
durationMillisecondsIntegerระยะเวลาขั้นต่ำ (เป็นมิลลิวินาที) หลังจากเวลาปัจจุบันที่ทริกเกอร์ควรทำงาน

รีเทิร์น

ClockTriggerBuilder — เครื่องมือสร้างสำหรับเชน


at(date)

ระบุเวลาที่ทริกเกอร์ทำงาน

// Creates a trigger for December 1, 2012
var triggerDay = new Date(2012, 11, 1);
ScriptApp.newTrigger("myFunction")
  .timeBased()
  .at(triggerDay)
  .create();

พารามิเตอร์

ชื่อTypeคำอธิบาย
dateDateออบเจ็กต์วันที่ซึ่งแสดงเวลาที่ทริกเกอร์ควรทำงาน

รีเทิร์น

ClockTriggerBuilder — เครื่องมือสร้างสำหรับเชน


atDate(year, month, day)

ระบุว่าทริกเกอร์จะเริ่มทำงานในวันที่ที่ระบุ โดยค่าเริ่มต้นตอนใกล้เที่ยงคืน (+/- 15 นาที)

// Schedules for January 1st, 2013
ScriptApp.newTrigger("myFunction")
  .timeBased()
  .atDate(2013, 1, 1)
  .create();

พารามิเตอร์

ชื่อTypeคำอธิบาย
yearIntegerปีปฏิทินที่จะกำหนดเวลาทริกเกอร์
monthIntegerเดือนตามปฏิทินที่จะกำหนดเวลาทริกเกอร์ (ควรเป็นตัวเลขตั้งแต่ 1 ถึง 12 รวมเลขตัวแรกและตัวสุดท้าย)
dayIntegerวันตามปฏิทินที่จะตั้งเวลาทริกเกอร์ (ควรเป็นตัวเลขตั้งแต่ 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();

พารามิเตอร์

ชื่อTypeคำอธิบาย
hourIntegerชั่วโมงที่จะเริ่มทำงาน

รีเทิร์น

ClockTriggerBuilder — เครื่องมือสร้างสำหรับเชน


create()

สร้างทริกเกอร์

รีเทิร์น

Trigger — ทริกเกอร์ตามกำหนดการที่สร้างใหม่


everyDays(n)

ระบุให้เรียกใช้ทริกเกอร์ทุก n วัน

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
nIntegerจำนวนวันระหว่างการดำเนินการ

รีเทิร์น

ClockTriggerBuilder — เครื่องมือสร้างสำหรับเชน


everyHours(n)

ระบุให้เรียกใช้ทริกเกอร์ทุก n ชั่วโมง

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
nIntegerจำนวนชั่วโมงระหว่างการดำเนินการ

รีเทิร์น

ClockTriggerBuilder — เครื่องมือสร้างสำหรับเชน


everyMinutes(n)

ระบุให้เรียกใช้ทริกเกอร์ทุก n นาที n ต้องเป็น 1, 5, 10, 15 หรือ 30

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
nIntegerจำนวนนาทีระหว่างการดำเนินการ

รีเทิร์น

ClockTriggerBuilder — เครื่องมือสร้างสำหรับเชน


everyWeeks(n)

ระบุให้เรียกใช้ทริกเกอร์ทุก n สัปดาห์

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
nIntegerจำนวนสัปดาห์ระหว่างการดำเนินการ

รีเทิร์น

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();

พารามิเตอร์

ชื่อTypeคำอธิบาย
timezoneStringเขตเวลาที่ใช้จัดการข้อมูลเวลาในกิจกรรม

รีเทิร์น

ClockTriggerBuilderClockTriggerBuilder นี้สำหรับการทำเชน


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();

พารามิเตอร์

ชื่อTypeคำอธิบาย
minuteIntegerนาทีที่จะเริ่มทำงาน

รีเทิร์น

ClockTriggerBuilder — เครื่องมือสร้างสำหรับเชน


onMonthDay(day)

ระบุวันที่ในเดือนที่ทริกเกอร์ทำงาน

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
dayIntegerวันของเดือนที่จะกำหนดให้ทริกเกอร์

รีเทิร์น

ClockTriggerBuilder — เครื่องมือสร้างสำหรับเชน


onWeekDay(day)

ระบุวันในสัปดาห์ที่ทริกเกอร์ทำงาน

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
dayWeekdayวันในสัปดาห์ที่จะเกิดไฟไหม้

รีเทิร์น

ClockTriggerBuilder — เครื่องมือสร้างสำหรับเชน