Class ClockTriggerBuilder

ClockTriggerBuilder

Trình tạo cho trình kích hoạt đồng hồ.

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
after(durationMilliseconds)	ClockTriggerBuilder	Chỉ định thời lượng tối thiểu (tính bằng mili giây) sau thời điểm hiện tại mà điều kiện kích hoạt chạy.
at(date)	ClockTriggerBuilder	Chỉ định thời điểm trình kích hoạt chạy.
atDate(year, month, day)	ClockTriggerBuilder	Chỉ định rằng điều kiện kích hoạt sẽ kích hoạt vào ngày đã cho, theo mặc định là gần nửa đêm (+/- 15 phút).
atHour(hour)	ClockTriggerBuilder	Chỉ định giờ mà điều kiện kích hoạt chạy.
create()	Trigger	Tạo điều kiện kích hoạt.
everyDays(n)	ClockTriggerBuilder	Chỉ định chạy điều kiện kích hoạt n ngày một lần.
everyHours(n)	ClockTriggerBuilder	Chỉ định chạy điều kiện kích hoạt sau mỗi n giờ.
everyMinutes(n)	ClockTriggerBuilder	Chỉ định chạy điều kiện kích hoạt mỗi n phút.
everyWeeks(n)	ClockTriggerBuilder	Chỉ định chạy điều kiện kích hoạt n tuần một lần.
inTimezone(timezone)	ClockTriggerBuilder	Chỉ định múi giờ cho ngày/giờ được chỉ định khi điều kiện kích hoạt chạy.
nearMinute(minute)	ClockTriggerBuilder	Chỉ định phút mà điều kiện kích hoạt chạy (thêm hoặc trừ 15 phút).
onMonthDay(day)	ClockTriggerBuilder	Chỉ định ngày trong tháng mà điều kiện kích hoạt chạy.
onWeekDay(day)	ClockTriggerBuilder	Chỉ định ngày trong tuần mà điều kiện kích hoạt chạy.

Tài liệu chi tiết

after(durationMilliseconds)

Chỉ định thời lượng tối thiểu (tính bằng mili giây) sau thời gian hiện tại mà điều kiện kích hoạt chạy. Thời lượng thực tế có thể khác nhau, nhưng sẽ không ít hơn thời lượng tối thiểu mà bạn chỉ định.

// Creates a trigger that runs 10 minutes later
ScriptApp.newTrigger('myFunction').timeBased().after(10 * 60 * 1000).create();

Tham số

Tên	Loại	Mô tả
durationMilliseconds	Integer	Thời lượng tối thiểu (tính bằng mili giây) sau thời gian hiện tại mà trình kích hoạt sẽ chạy.

Cầu thủ trả bóng

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

---

at(date)

Chỉ định thời điểm trình kích hoạt chạy.

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

Tham số

Tên	Loại	Mô tả
date	Date	Đối tượng Date đại diện cho thời điểm trình kích hoạt sẽ chạy.

Cầu thủ trả bóng

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

---

atDate(year, month, day)

Chỉ định rằng điều kiện kích hoạt sẽ kích hoạt vào ngày đã cho, theo mặc định là gần nửa đêm (+/- 15 phút).

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

Tham số

Tên	Loại	Mô tả
year	Integer	Năm dương lịch để lên lịch điều kiện kích hoạt.
month	Integer	Tháng theo lịch để lên lịch điều kiện kích hoạt (phải là một số từ 1 đến 12, bao gồm cả 1 và 12).
day	Integer	Ngày trong lịch để lên lịch kích hoạt (phải là một số từ 1 đến 31, bao gồm cả ngày).

Cầu thủ trả bóng

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

---

atHour(hour)

Chỉ định giờ mà điều kiện kích hoạt chạy.

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

Tham số

Tên	Loại	Mô tả
hour	Integer	Giờ kích hoạt.

Cầu thủ trả bóng

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

---

create()

Tạo điều kiện kích hoạt.

Cầu thủ trả bóng

Trigger – Trình kích hoạt theo lịch mới tạo.

---

everyDays(n)

Chỉ định chạy điều kiện kích hoạt n ngày một lần.

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

Tham số

Tên	Loại	Mô tả
n	Integer	Số ngày giữa các lần thực thi.

Cầu thủ trả bóng

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

---

everyHours(n)

Chỉ định chạy điều kiện kích hoạt sau mỗi n giờ.

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

Tham số

Tên	Loại	Mô tả
n	Integer	Số giờ giữa các lần thực thi.

Cầu thủ trả bóng

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

---

everyMinutes(n)

Chỉ định chạy điều kiện kích hoạt mỗi n phút. n phải là 1, 5, 10, 15 hoặc 30.

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

Tham số

Tên	Loại	Mô tả
n	Integer	Số phút giữa các lần thực thi.

Cầu thủ trả bóng

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

---

everyWeeks(n)

Chỉ định chạy điều kiện kích hoạt n tuần một lần.

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

Tham số

Tên	Loại	Mô tả
n	Integer	Số tuần giữa các lần thực thi.

Cầu thủ trả bóng

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

---

inTimezone(timezone)

Chỉ định múi giờ cho ngày/giờ được chỉ định khi điều kiện kích hoạt chạy. Theo mặc định, múi giờ là múi giờ của tập lệnh.

Danh sách chuỗi múi giờ hợp lệ tương ứng với các chuỗi múi giờ hợp lệ do Joda.org liệt kê. Chuỗi múi giờ không hợp lệ sẽ khiến tập lệnh gửi lỗi.

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

Tham số

Tên	Loại	Mô tả
timezone	String	Múi giờ dùng để xử lý thông tin thời gian trong sự kiện.

Cầu thủ trả bóng

ClockTriggerBuilder — ClockTriggerBuilder này, để tạo chuỗi.

---

nearMinute(minute)

Chỉ định phút mà điều kiện kích hoạt chạy (thêm hoặc trừ 15 phút). Nếu bạn không gọi nearMinute(), hệ thống sẽ sử dụng một giá trị phút ngẫu nhiên.

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

Tham số

Tên	Loại	Mô tả
minute	Integer	Phút kích hoạt.

Cầu thủ trả bóng

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

---

onMonthDay(day)

Chỉ định ngày trong tháng mà điều kiện kích hoạt chạy.

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

Tham số

Tên	Loại	Mô tả
day	Integer	Ngày trong tháng mà bạn muốn lên lịch cho điều kiện kích hoạt.

Cầu thủ trả bóng

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

---

onWeekDay(day)

Chỉ định ngày trong tuần mà điều kiện kích hoạt chạy.

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

Tham số

Tên	Loại	Mô tả
day	Weekday	Ngày trong tuần để kích hoạt.

Cầu thủ trả bóng

ClockTriggerBuilder – Trình tạo để tạo chuỗi.