Một trường nhập dữ liệu cho phép người dùng nhập thời gian.
Dành cho tiện ích bổ sung của Google Workspace và ứng dụng Google Chat.
const dateTimePicker = CardService.newTimePicker() .setTitle('Enter the time.') .setFieldName('time_field') // Set default value as 3:30 AM. .setHours(3) .setMinutes(30) .setOnChangeAction( CardService.newAction().setFunctionName('handleDateTimeChange'), );
Phương thức
| Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
add | Widget | Thêm thao tác sự kiện có thể thực hiện trên tiện ích. |
set | Time | Đặt tên trường xác định bộ chọn này trong đối tượng sự kiện được tạo khi có một hoạt động tương tác trên giao diện người dùng. |
set | Time | Đặt giá trị giờ được điền sẵn để đặt trong trường nhập. |
set | Widget | Đặt mã nhận dạng duy nhất được chỉ định dùng để xác định tiện ích cần thay đổi. |
set | Time | Đặt giá trị phút được điền sẵn để đặt trong trường nhập. |
set | Time | Đặt một Action mà tập lệnh thực hiện bất cứ khi nào giá trị đầu vào của bộ chọn thay đổi. |
set | Time | Đặt tiêu đề xuất hiện phía trên trường nhập. |
set | Widget | Đặt chế độ hiển thị của tiện ích. |
Tài liệu chi tiết
add
Thêm thao tác sự kiện có thể thực hiện trên tiện ích.
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
event | Event | Event cần thêm. |
Cầu thủ trả bóng
Widget – Đối tượng, để liên kết.
set
Đặt tên trường xác định bộ chọn này trong đối tượng sự kiện được tạo khi có một hoạt động tương tác trên giao diện người dùng. Người dùng sẽ nhìn thấy tên trường. Bắt buộc; tên trường được chỉ định phải là duy nhất.
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
field | String | Tên cần chỉ định cho đầu vào này. |
Cầu thủ trả bóng
Time – Bộ chọn này dùng để tạo chuỗi.
set
Đặt giá trị giờ được điền sẵn để đặt trong trường nhập.
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
hours | Integer | Giá trị giờ mặc định được đặt trong dữ liệu đầu vào, trong khoảng từ 0 đến 23. Tham số này luôn được biểu thị dưới dạng một chuỗi trong các tham số lệnh gọi lại biểu mẫu. |
Cầu thủ trả bóng
Time – Bộ chọn này dùng để tạo chuỗi.
set
Đặt mã nhận dạng duy nhất được chỉ định dùng để xác định tiện ích cần thay đổi. Chỉ có Tiện ích bổ sung mới hỗ trợ thao tác thay đổi tiện ích.
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
id | String | Mã nhận dạng của tiện ích, có giới hạn 64 ký tự và ở định dạng `[a-zA-Z0-9-]+`. |
Cầu thủ trả bóng
Widget – Đối tượng này, để liên kết.
set
Đặt giá trị phút được điền sẵn để đặt trong trường nhập.
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
minutes | Integer | Giá trị mặc định tính bằng phút được đặt trong dữ liệu đầu vào, trong khoảng từ 0 đến 59. Tham số này luôn được biểu thị dưới dạng một chuỗi trong các tham số lệnh gọi lại biểu mẫu. |
Cầu thủ trả bóng
Time – Bộ chọn này dùng để tạo chuỗi.
set
Đặt một Action mà tập lệnh thực hiện bất cứ khi nào giá trị đầu vào của bộ chọn thay đổi.
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
action | Action | Hành động cần thực hiện. |
Cầu thủ trả bóng
Time – Bộ chọn này dùng để tạo chuỗi.
set
Đặt tiêu đề xuất hiện phía trên trường nhập.
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
title | String | Tiêu đề của trường nhập. |
Cầu thủ trả bóng
Time – Bộ chọn này dùng để tạo chuỗi.
set
Đặt chế độ hiển thị của tiện ích. Giá trị mặc định là "VISIBLE".
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
visibility | Visibility | Visibility của tiện ích. |
Cầu thủ trả bóng
Widget – Đối tượng, để liên kết.