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

`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 ที่แสดงเวลาที่ควรเรียกใช้ทริกเกอร์

รีเทิร์น

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 — This ClockTriggerBuilder, for chaining.

`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 — ตัวสร้างสำหรับการเชื่อมโยง