Một trường nhập dữ liệu cho phép người dùng nhập ngày và giờ.
Được cung cấp cho tiện ích bổ sung của Google Workspace và ứng dụng Google Chat.
var dateTimePicker = CardService.newDateTimePicker() .setTitle("Enter the date and time.") .setFieldName("date_time_field") // Set default value as Jan 1, 2018, 3:00 AM UTC. Either a number or string is acceptable. .setValueInMsSinceEpoch(1514775600) // EDT time is 5 hours behind UTC. .setTimeZoneOffsetInMins(-5 * 60) .setOnChangeAction(CardService.newAction() .setFunctionName("handleDateTimeChange"));
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
setFieldName(fieldName) | DateTimePicker | Đặ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. |
setOnChangeAction(action) | DateTimePicker | Đặt một Action mà tập lệnh sẽ thực hiện mỗi khi giá trị nhập vào bộ chọn thay đổi. |
setTimeZoneOffsetInMins(timeZoneOffsetMins) | DateTimePicker | Đặt số phút mà múi giờ sẽ bù trừ so với giờ UTC. |
setTitle(title) | DateTimePicker | Đặt tiêu đề hiển thị phía trên trường nhập dữ liệu. |
setValueInMsSinceEpoch(valueMsEpoch) | DateTimePicker | Thiết lập giá trị điền sẵn để đặt trong trường nhập dữ liệu. |
setValueInMsSinceEpoch(valueMsEpoch) | DateTimePicker | Thiết lập giá trị điền sẵn để đặt trong trường nhập dữ liệu. |
Tài liệu chi tiết
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ó 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.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
fieldName | String | Tên để gán cho dữ liệu nhập này. |
Cầu thủ trả bóng
DateTimePicker
– Bộ chọn này để tạo chuỗi.
setOnChangeAction(action)
Đặt một Action
mà tập lệnh sẽ thực hiện mỗi khi giá trị nhập vào bộ chọn thay đổi.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
action | Action | Hành động cần thực hiện. |
Cầu thủ trả bóng
DateTimePicker
– Bộ chọn này để tạo chuỗi.
setTimeZoneOffsetInMins(timeZoneOffsetMins)
Đặt số phút mà múi giờ sẽ bù trừ so với giờ UTC. Nếu được đặt, ngày và giờ sẽ hiển thị theo múi giờ được chỉ định. Nếu bạn không đặt chính sách này, thời gian sẽ hiển thị theo múi giờ của người dùng.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
timeZoneOffsetMins | Integer | Số phút mà múi giờ bị lệch so với giờ UTC. |
Cầu thủ trả bóng
DateTimePicker
– 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ên | Loại | Nội dung mô tả |
---|---|---|
title | String | Tiêu đề của trường nhập dữ liệu. |
Cầu thủ trả bóng
DateTimePicker
– Bộ chọn này để tạo chuỗi.
setValueInMsSinceEpoch(valueMsEpoch)
Thiết lập giá trị điền sẵn để đặt trong trường nhập dữ liệu.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
valueMsEpoch | Number | Giá trị mặc định được đặt trong dữ liệu đầu vào dưới dạng số, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống. 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 của biểu mẫu. |
Cầu thủ trả bóng
DateTimePicker
– Bộ chọn này để tạo chuỗi.
setValueInMsSinceEpoch(valueMsEpoch)
Thiết lập giá trị điền sẵn để đặt trong trường nhập dữ liệu.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
valueMsEpoch | String | Giá trị mặc định đặt trong dữ liệu đầu vào dưới dạng một chuỗi, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống. 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 của biểu mẫu. |
Cầu thủ trả bóng
DateTimePicker
– Bộ chọn này để tạo chuỗi.