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

พารามิเตอร์

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

รีเทิร์น

ClockTriggerBuilder — ตัวสร้างสำหรับใช้ต่อเชื่อม


at(date)

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

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

พารามิเตอร์

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

รีเทิร์น

ClockTriggerBuilder — ตัวสร้างสำหรับใช้ต่อเชื่อม


atDate(year, month, day)

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

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

พารามิเตอร์

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
hourIntegerชั่วโมงที่จะเริ่มแสดง

รีเทิร์น

ClockTriggerBuilder — ตัวสร้างสำหรับใช้ต่อเชื่อม


create()

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

รีเทิร์น

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


everyDays(n)

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

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

พารามิเตอร์

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

รีเทิร์น

ClockTriggerBuilder — ตัวสร้างสำหรับใช้ต่อเชื่อม


everyHours(n)

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

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

พารามิเตอร์

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

รีเทิร์น

ClockTriggerBuilder — ตัวสร้างสำหรับใช้ต่อเชื่อม


everyMinutes(n)

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
nIntegerจำนวนนาทีระหว่างการดำเนินการแต่ละครั้ง

รีเทิร์น

ClockTriggerBuilder — ตัวสร้างสำหรับใช้ต่อเชื่อม


everyWeeks(n)

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

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

พารามิเตอร์

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

พารามิเตอร์

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
minuteIntegerนาทีที่จะเริ่มแสดง

รีเทิร์น

ClockTriggerBuilder — ตัวสร้างสำหรับใช้ต่อเชื่อม


onMonthDay(day)

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dayIntegerวันที่ของเดือนที่ควรตั้งเวลาทริกเกอร์

รีเทิร์น

ClockTriggerBuilder — ตัวสร้างสำหรับใช้ต่อเชื่อม


onWeekDay(day)

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

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

พารามิเตอร์

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

รีเทิร์น

ClockTriggerBuilder — ตัวสร้างสำหรับใช้ต่อเชื่อม