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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
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()

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

รีเทิร์น

Trigger — ทริกเกอร์ที่ตั้งเวลาไว้ใหม่

---

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 — เครื่องมือสร้างสำหรับการทำสายโซ่