Class TimePicker

TimePicker

Một trường nhập dữ liệu cho phép người dùng nhập thời gian.

Có sẵn 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ứcKiểu dữ liệu trả vềMô tả ngắn
addEventAction(eventAction)WidgetThêm hành động sự kiện có thể thực hiện trên tiện ích.
setFieldName(fieldName)TimePickerĐặ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ó tương tác với giao diện người dùng.
setHours(hours)TimePickerĐặt giá trị giờ được điền sẵn để đặt trong trường nhập dữ liệu.
setId(id)WidgetĐặt mã nhận dạng duy nhất được gán dùng để xác định tiện ích cần thay đổi.
setMinutes(minutes)TimePickerĐặt giá trị phút được điền sẵn để đặt trong trường nhập dữ liệu.
setOnChangeAction(action)TimePickerĐặt một Action mà tập lệnh thực hiện bất cứ khi nào giá trị nhập của bộ chọn thay đổi.
setTitle(title)TimePickerĐặt tiêu đề hiển thị phía trên trường nhập dữ liệu.
setVisibility(visibility)WidgetĐặt chế độ hiển thị của tiện ích.

Tài liệu chi tiết

addEventAction(eventAction)

Thêm hành động sự kiện có thể thực hiện trên tiện ích.

Tham số

TênLoạiMô tả
eventActionEventActionEventAction cần thêm.

Cầu thủ trả bóng

Widget – Đối tượng, để tạo chuỗi.

setFieldName(fieldName)

Đặ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ó tương tác với giao diện người dùng. Người dùng có thể 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.

Tham số

TênLoạiMô tả
fieldNameStringTên cần gán cho giá trị nhập này.

Cầu thủ trả bóng

TimePicker – Bộ chọn này, để tạo chuỗi.

setHours(hours)

Đặt giá trị giờ được điền sẵn để đặt trong trường nhập dữ liệu.

Tham số

TênLoạiMô tả
hoursIntegerGiá trị giờ mặc định được đặt trong giá trị nhập, phạm vi từ 0 đến 23. Giá trị này luôn được biểu thị dưới dạng chuỗi trong các tham số gọi lại biểu mẫu.

Cầu thủ trả bóng

TimePicker – Bộ chọn này, để tạo chuỗi.

setId(id)

Đặt mã nhận dạng duy nhất được gán dùng để xác định tiện ích cần thay đổi. Tính năng thay đổi tiện ích chỉ được hỗ trợ trong Tiện ích bổ sung.

Tham số

TênLoạiMô tả
idStringMã 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, để tạo chuỗi.

setMinutes(minutes)

Đặt giá trị phút được điền sẵn để đặt trong trường nhập dữ liệu.

Tham số

TênLoạiMô tả
minutesIntegerGiá trị phút mặc định được đặt trong giá trị nhập, phạm vi từ 0 đến 59. Giá trị này luôn được biểu thị dưới dạng chuỗi trong các tham số gọi lại biểu mẫu.

Cầu thủ trả bóng

TimePicker – Bộ chọn này, để tạo chuỗi.

setOnChangeAction(action)

Đặt một Action mà tập lệnh thực hiện bất cứ khi nào giá trị nhập của bộ chọn thay đổi.

Tham số

TênLoạiMô tả
actionActionHành động cần thực hiện.

Cầu thủ trả bóng

TimePicker – Bộ chọn này, để tạo chuỗi.

setTitle(title)

Đặt tiêu đề hiển thị phía trên trường nhập dữ liệu.

Tham số

TênLoạiMô tả
titleStringTiêu đề trường nhập dữ liệu.

Cầu thủ trả bóng

TimePicker – Bộ chọn này, để tạo chuỗi.

setVisibility(visibility)

Đặt chế độ hiển thị của tiện ích. Giá trị mặc định là `VISIBLE`.

Tham số

TênLoạiMô tả
visibilityVisibilityVisibility của tiện ích.

Cầu thủ trả bóng

Widget – Đối tượng, để tạo chuỗi.