Class DateTimePicker

Bộ chọnngàygiờ

Một trường nhập dữ liệu cho phép người dùng nhập ngày và giờ.

Hỗ trợ xác thực dữ liệu trên biểu mẫu mà người dùng gửi. Khi Action.setAllWidgetsAreRequired(allWidgetsAreRequired) được đặt thành true hoặc tiện ích này được chỉ định thông qua Action.addRequiredWidget(requiredWidget), thao tác gửi sẽ bị chặn trừ phi bạn chọn một giá trị.

Dành cho tiện ích bổ sung của Google Workspace và ứng dụng Google Chat. 

const 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ứcKiểu dữ liệu trả vềMô tả ngắn
addEventAction(eventAction)WidgetThêm thao tác sự kiện có thể thực hiện trên tiện ích.
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.
setHostAppDataSource(hostAppDataSource)DateTimePickerTrong một đặc vụ Google Workspace Studio, hãy cho phép các biến đầu vào chấp nhận đầu ra ngày giờ từ các bước khác trong đặc vụ.
setId(id)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.
setOnChangeAction(action)DateTimePickerĐặ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.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerĐặt số phút mà múi giờ sẽ được điều chỉnh so với giờ UTC.
setTitle(title)DateTimePickerĐặt tiêu đề xuất hiện phía trên trường nhập.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerĐặt giá trị được điền sẵn sẽ được đặt trong trường nhập.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerĐặt giá trị được điền sẵn sẽ được đặt trong trường nhập.
setVisibility(visibility)WidgetĐặt chế độ hiển thị của tiện ích.

Tài liệu chi tiết

addEventAction(eventAction)

Thêm thao tác sự kiện có thể thực hiện trên tiện ích.

Thông số

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

Cầu thủ trả bóng

Widget – Đối tượng, để liên kế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.

Thông số

TênLoạiMô tả
fieldNameStringTên cần chỉ định cho đầu vào này.

Cầu thủ trả bóng

DateTimePicker – Bộ chọn này dùng để tạo chuỗi.

setHostAppDataSource(hostAppDataSource)

Trong một đặc vụ Google Workspace Studio, hãy cho phép các biến đầu vào chấp nhận đầu ra ngày giờ từ các bước khác trong đặc vụ. Ví dụ: nhận thời gian gửi thư trên Gmail hoặc ngày mà một sự kiện trên lịch được lên lịch.

Chỉ dành cho các tiện ích bổ sung của Google Workspace mở rộng Google Workspace Studio. 

const workflowDataSource =
    CardService.newWorkflowDataSource().setIncludeVariables(true);

const hostAppDataSource =
    CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource);

const dateTimePicker = CardService.newDateTimePicker()
                          .setTitle('Enter the date and time.')
                          .setFieldName('date_time_field')
                          .setHostAppDataSource(hostAppDataSource);

Thông số

TênLoạiMô tả
hostAppDataSourceHostAppDataSourceNguồn dữ liệu.

Cầu thủ trả bóng

DateTimePicker – Bộ chọn này dùng để tạo chuỗi.

setId(id)

Đặ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ê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, để liên kết.

setOnChangeAction(action)

Đặ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ênLoạiMô tả
actionActionHành động cần thực hiện.

Cầu thủ trả bóng

DateTimePicker – Bộ chọn này dùng để tạo chuỗi.

setTimeZoneOffsetInMins(timeZoneOffsetMins)

Đặt số phút mà múi giờ sẽ lệch so với giờ UTC. Nếu được đặt, ngày và giờ sẽ hiển thị theo múi giờ đã chỉ định. Nếu bạn không đặt, thì thời gian sẽ hiển thị theo múi giờ của người dùng.

Thông số

TênLoạiMô tả
timeZoneOffsetMinsIntegerSố phút mà múi giờ lệch so với giờ UTC.

Cầu thủ trả bóng

DateTimePicker – Bộ chọn này dùng để tạo chuỗi.

setTitle(title)

Đặt tiêu đề xuất hiện phía trên trường nhập.

Thông số

TênLoạiMô tả
titleStringTiêu đề của trường nhập.

Cầu thủ trả bóng

DateTimePicker – Bộ chọn này dùng để tạo chuỗi.

setValueInMsSinceEpoch(valueMsEpoch)

Đặt giá trị được điền sẵn sẽ được đặt trong trường nhập.

Thông số

TênLoạiMô tả
valueMsEpochNumberGiá trị mặc định được đặt trong dữ liệu đầu vào dưới dạng một số, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống. 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

DateTimePicker – Bộ chọn này dùng để tạo chuỗi.

setValueInMsSinceEpoch(valueMsEpoch)

Đặt giá trị được điền sẵn sẽ được đặt trong trường nhập.

Thông số

TênLoạiMô tả
valueMsEpochStringGiá trị mặc định được đặ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. 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

DateTimePicker – Bộ chọn này dùng để tạo chuỗi.

setVisibility(visibility)

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

Thông số

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

Cầu thủ trả bóng

Widget – Đối tượng, để liên kết.