Class DateTimePicker

DateTimePicker

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 việc gửi biểu mẫu. 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), thì thao tác gửi sẽ bị chặn trừ phi bạn chọn một giá trị.

Dùng được cho các 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 tương tác với giao diện người dùng.
setHostAppDataSource(hostAppDataSource)DateTimePickerTrong một tác nhân Google Workspace Studio, cho phép các biến đầu vào chấp nhận dữ liệu đầu ra ngày giờ từ các bước khác trong tác nhân.
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 được 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ờ cần được 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Đặt giá trị được điền sẵn sẽ được đặt trong trường nhập dữ liệu.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerĐặt giá trị được điền sẵn sẽ được đặt trong 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 thao tác 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ó một 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ị đầu vào này.

Cầu thủ trả bóng

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

setHostAppDataSource(hostAppDataSource)

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

Chỉ dùng được 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);

Tham số

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

Cầu thủ trả bóng

DateTimePicker – Bộ chọn này để 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 được 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.

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.

Tham 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 để tạo chuỗi.

setTimeZoneOffsetInMins(timeZoneOffsetMins)

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

Tham số

TênLoạiMô tả
timeZoneOffsetMinsIntegerSố phút mà múi giờ được bù trừ 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ênLoạiMô tả
titleStringTiêu đề 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)

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

Tham số

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

setValueInMsSinceEpoch(valueMsEpoch)

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

Tham số

TênLoạiMô tả
valueMsEpochStringGiá trị mặc định được đặt trong giá trị đầu vào dưới dạng chuỗi, tính bằng mili giây kể từ thời gian bắt đầu. Giá trị này luôn được biểu thị dưới dạng 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 để 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.