Class DatePicker

Công cụchọnngày

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

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

const dateTimePicker =
    CardService.newDatePicker()
        .setTitle('Enter the date.')
        .setFieldName('date_field')
        // Set default value as Jan 1, 2018 UTC. Either a number or string is
        // acceptable.
        .setValueInMsSinceEpoch(1514775600)
        .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)DatePickerĐặ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.
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)DatePickerĐặ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.
setTitle(title)DatePickerĐặt tiêu đề xuất hiện phía trên trường nhập.
setValueInMsSinceEpoch(valueMsEpoch)DatePickerĐặt giá trị được điền sẵn sẽ được đặt trong trường nhập.
setValueInMsSinceEpoch(valueMsEpoch)DatePickerĐặ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

DatePicker – 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

DatePicker – 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

DatePicker – 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. Hệ thống chỉ sử dụng ngày của thời gian bắt đầu và loại bỏ thời gian của thời gian bắt đầu. 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

DatePicker – 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. Hệ thống chỉ sử dụng ngày của thời gian bắt đầu và loại bỏ thời gian của thời gian bắt đầu. 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

DatePicker – 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.