ช่องป้อนข้อมูลที่อนุญาตให้ผู้ใช้ป้อนวันที่และเวลา
รองรับการตรวจสอบการส่งแบบฟอร์ม เมื่อตั้งค่า Action.setAllWidgetsAreRequired(allWidgetsAreRequired) เป็น
true หรือระบุวิดเจ็ตนี้ผ่าน Action.addRequiredWidget(requiredWidget) ระบบจะบล็อกการดำเนินการส่ง
เว้นแต่จะมีการเลือกค่า
พร้อมให้บริการสำหรับส่วนเสริมของ Google Workspace และแอป 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'), );
เมธอด
| วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
|---|---|---|
set | Date | กำหนดชื่อฟิลด์ที่ระบุเครื่องมือเลือกนี้ในออบเจ็กต์เหตุการณ์ที่สร้างขึ้นเมื่อมีการโต้ตอบ UI |
set | Date | ในโฟลว์ Google Workspace ฟังก์ชัน input variables จะยอมรับเอาต์พุตวันที่และเวลาจากขั้นตอนอื่นๆ ในโฟลว์ |
set | Date | ตั้งค่า Action ที่สคริปต์จะดำเนินการเมื่อใดก็ตามที่อินพุตของเครื่องมือเลือกมีการเปลี่ยนแปลง |
set | Date | กำหนดจำนวนนาทีที่ควรชดเชยเขตเวลาจาก UTC |
set | Date | กำหนดชื่อที่แสดงเหนือช่องป้อนข้อมูล |
set | Date | กำหนดค่าที่กรอกไว้ล่วงหน้าที่จะตั้งค่าในช่องป้อนข้อมูล |
set | Date | กำหนดค่าที่กรอกไว้ล่วงหน้าที่จะตั้งค่าในช่องป้อนข้อมูล |
เอกสารโดยละเอียด
set Field Name(fieldName)
กำหนดชื่อฟิลด์ที่ระบุเครื่องมือเลือกนี้ในออบเจ็กต์เหตุการณ์ที่สร้างขึ้นเมื่อมีการโต้ตอบ UI ผู้ใช้จะเห็นชื่อฟิลด์ ต้องระบุ ชื่อฟิลด์ที่ระบุต้องไม่ซ้ำกัน
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
field | String | ชื่อที่จะกำหนดให้กับอินพุตนี้ |
รีเทิร์น
Date — เครื่องมือเลือกนี้สำหรับการเชื่อมโยง
set Host App Data Source(hostAppDataSource)
ในโฟลว์ Google Workspace ฟังก์ชัน input variables จะยอมรับเอาต์พุตวันที่และเวลาจากขั้นตอนอื่นๆ ในโฟลว์ เช่น รับ เวลาที่ส่งข้อความ Gmail หรือวันที่ที่กำหนดเวลากิจกรรมในปฏิทิน
พร้อมใช้งานผ่านโปรแกรม Gemini เวอร์ชันอัลฟ่าสำหรับส่วนเสริม Google Workspace ที่ขยาย Google Workspace Flow เท่านั้น
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);
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
host | Host | แหล่งข้อมูล |
รีเทิร์น
Date — เครื่องมือเลือกนี้สำหรับการเชื่อมโยง
set On Change Action(action)
ตั้งค่า Action ที่สคริปต์จะดำเนินการเมื่อใดก็ตามที่อินพุตของเครื่องมือเลือกมีการเปลี่ยนแปลง
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
action | Action | การดำเนินการที่ต้องทำ |
รีเทิร์น
Date — เครื่องมือเลือกนี้สำหรับการเชื่อมโยง
set Time Zone Offset In Mins(timeZoneOffsetMins)
กำหนดจำนวนนาทีที่ควรชดเชยเขตเวลาจาก UTC หากตั้งค่าไว้ ระบบจะแสดงวันที่และเวลาในเขตเวลาที่ระบุ หากไม่ได้ตั้งค่าไว้ ระบบจะแสดงเวลาในเขตเวลาของผู้ใช้
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
time | Integer | จำนวนนาทีที่เขตเวลาออฟเซ็ตจาก UTC |
รีเทิร์น
Date — เครื่องมือเลือกนี้สำหรับการเชื่อมโยง
set Title(title)
กำหนดชื่อที่แสดงเหนือช่องป้อนข้อมูล
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
title | String | ชื่อช่องป้อนข้อมูล |
รีเทิร์น
Date — เครื่องมือเลือกนี้สำหรับการเชื่อมโยง
set Value In Ms Since Epoch(valueMsEpoch)
กำหนดค่าที่กรอกไว้ล่วงหน้าที่จะตั้งค่าในช่องป้อนข้อมูล
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
value | Number | ค่าเริ่มต้นที่ป้อนเป็นตัวเลขในหน่วยมิลลิวินาทีตั้งแต่ Epoch โดยจะแสดงเป็นสตริงในพารามิเตอร์การเรียกกลับของแบบฟอร์มเสมอ |
รีเทิร์น
Date — เครื่องมือเลือกนี้สำหรับการเชื่อมโยง
set Value In Ms Since Epoch(valueMsEpoch)
กำหนดค่าที่กรอกไว้ล่วงหน้าที่จะตั้งค่าในช่องป้อนข้อมูล
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
value | String | ค่าเริ่มต้นที่วางไว้ในอินพุตเป็นสตริงในหน่วยมิลลิวินาทีตั้งแต่ Epoch โดยจะแสดงเป็นสตริงในพารามิเตอร์การเรียกกลับของแบบฟอร์มเสมอ |
รีเทิร์น
Date — เครื่องมือเลือกนี้สำหรับการเชื่อมโยง