Class DateTimePicker
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Bộ chọnNgàyGiờ
Trường nhập 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), thao tác gửi sẽ bị chặn trừ phi bạn chọn một giá trị.
Có sẵn 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'),
);
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ó tương tác với 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ên | Loại | Mô tả |
fieldName | String | Tên cần chỉ định cho dữ liệu đầu vào 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 thực hiện bất cứ khi nào dữ liệu đầu vào của bộ chọn thay đổi.
Thông số
| Tên | Loại | 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ẽ chênh 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ời gian sẽ hiển thị theo múi giờ của người dùng.
Thông số
| Tên | Loại | Mô tả |
timeZoneOffsetMins | Integer | Số phút mà múi giờ chênh 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.
Thông số
| Tên | Loại | Mô tả |
title | String | Tiêu đề 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 trong trường nhập.
Thông số
| Tên | Loại | 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. Loại dữ liệu 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 của 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 trong trường nhập.
Thông số
| Tên | Loại | Mô tả |
valueMsEpoch | String | Giá trị mặc định được đặt trong dữ liệu đầu vào dưới dạng chuỗi, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống. Loại 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 của biểu mẫu. |
Cầu thủ trả bóng
DateTimePicker – Bộ chọn này, để tạo chuỗi.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003eDateTimePicker is an input field that allows users to input both a date and a time within Google Workspace Add-ons and Google Chat apps.\u003c/p\u003e\n"],["\u003cp\u003eIt provides functionalities to set a title, a default value, and a specific time zone for the date and time selection.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can set a field name for identifying the picker in events, and trigger custom actions when the input changes using \u003ccode\u003esetOnChangeAction()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe prefilled value can be set using milliseconds since the epoch, represented as either a number or a string.\u003c/p\u003e\n"]]],[],null,["# Class DateTimePicker\n\nDateTimePicker\n\nAn input field that allows users to input a date and time.\n\nSupports form submission validation. When [Action.setAllWidgetsAreRequired(allWidgetsAreRequired)](/apps-script/reference/card-service/action#setAllWidgetsAreRequired(Boolean)) is set to\n`true` or this widget is specified through [Action.addRequiredWidget(requiredWidget)](/apps-script/reference/card-service/action#addRequiredWidget(String)), the submission\naction is blocked unless a value is selected.\n\nAvailable for Google Workspace add-ons and Google Chat apps.\n\n```javascript\nconst dateTimePicker =\n CardService.newDateTimePicker()\n .setTitle('Enter the date and time.')\n .setFieldName('date_time_field')\n // Set default value as Jan 1, 2018, 3:00 AM UTC. Either a number or\n // string is acceptable.\n .setValueInMsSinceEpoch(1514775600)\n // EDT time is 5 hours behind UTC.\n .setTimeZoneOffsetInMins(-5 * 60)\n .setOnChangeAction(\n CardService.newAction().setFunctionName('handleDateTimeChange'),\n );\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|----------------------------------------------------------------------------------|---------------------|--------------------------------------------------------------------------------------------------------------------------|\n| [setFieldName(fieldName)](#setFieldName(String)) | [DateTimePicker](#) | Sets the field name that identifies this picker in the event object that is generated when there is a UI interaction. |\n| [setOnChangeAction(action)](#setOnChangeAction(Action)) | [DateTimePicker](#) | Sets an [Action](/apps-script/reference/card-service/action) that the script performs whenever the picker input changes. |\n| [setTimeZoneOffsetInMins(timeZoneOffsetMins)](#setTimeZoneOffsetInMins(Integer)) | [DateTimePicker](#) | Sets the number of minutes that the time zone should be offset from UTC. |\n| [setTitle(title)](#setTitle(String)) | [DateTimePicker](#) | Sets the title displayed above the input field. |\n| [setValueInMsSinceEpoch(valueMsEpoch)](#setValueInMsSinceEpoch(Number)) | [DateTimePicker](#) | Sets the prefilled value to be set in the input field. |\n| [setValueInMsSinceEpoch(valueMsEpoch)](#setValueInMsSinceEpoch(String)) | [DateTimePicker](#) | Sets the prefilled value to be set in the input field. |\n\nDetailed documentation\n----------------------\n\n### `set``Field``Name(fieldName)`\n\nSets the field name that identifies this picker in the event object that is generated when\nthere is a UI interaction. The field name is visible to the user. Required; the specified field\nname must be unique.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------------|----------|-----------------------------------|\n| `field``Name` | `String` | The name to assign to this input. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining.\n\n*** ** * ** ***\n\n### `set``On``Change``Action(action)`\n\nSets an [Action](/apps-script/reference/card-service/action) that the script performs whenever the picker input changes.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|------------------------------------------------------|---------------------|\n| `action` | [Action](/apps-script/reference/card-service/action) | The action to take. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining.\n\n*** ** * ** ***\n\n### `set``Time``Zone``Offset``In``Mins(timeZoneOffsetMins)`\n\nSets the number of minutes that the time zone should be offset from UTC. If set, the date and\ntime is displayed in the specified time zone. If not set, the time is displayed in the user's\ntime zone.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------------------------|-----------|--------------------------------------------------------------|\n| `time``Zone``Offset``Mins` | `Integer` | The number of minutes that the time zone is offset from UTC. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining.\n\n*** ** * ** ***\n\n### `set``Title(title)`\n\nSets the title displayed above the input field.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|----------|------------------------|\n| `title` | `String` | The input field title. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining.\n\n*** ** * ** ***\n\n### `set``Value``In``Ms``Since``Epoch(valueMsEpoch)`\n\nSets the prefilled value to be set in the input field.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `value``Ms``Epoch` | `Number` | The default value placed in the input as a number, in milliseconds since the epoch. It is always represented as a string in the form callback parameters. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining.\n\n*** ** * ** ***\n\n### `set``Value``In``Ms``Since``Epoch(valueMsEpoch)`\n\nSets the prefilled value to be set in the input field.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `value``Ms``Epoch` | `String` | The default value placed in the input as a string, in milliseconds since the epoch. It is always represented as a string in the form callback parameters. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining."]]
