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
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 quy trình Google Workspace, biến đầu vào cho phép chấp nhận đầu ra ngày giờ từ các bước khác trong quy trình.
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.

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.

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

setHostAppDataSource(hostAppDataSource)

Trong một quy trình Google Workspace, biến đầu vào cho phép chấp nhận đầu ra ngày giờ từ các bước khác trong quy trình. 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ỉ có trong chương trình Gemini Alpha cho các tiện ích bổ sung Google Workspace mở rộng Google Workspace Flows. 

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, để 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.

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

setTimeZoneOffsetInMins(timeZoneOffsetMins)

Đặt số phút mà múi giờ sẽ được điều chỉnh 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, để 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, để 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, để 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, để tạo chuỗi.