Class DateTimePicker

เครื่องมือเลือกวันที่และเวลา

ช่องป้อนข้อมูลที่อนุญาตให้ผู้ใช้ป้อนวันที่และเวลา

รองรับการตรวจสอบการส่งแบบฟอร์ม เมื่อตั้งค่า 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'),
        );

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
setFieldName(fieldName)DateTimePickerกำหนดชื่อฟิลด์ที่ระบุเครื่องมือเลือกนี้ในออบเจ็กต์เหตุการณ์ที่สร้างขึ้นเมื่อมีการโต้ตอบ UI
setHostAppDataSource(hostAppDataSource)DateTimePickerในโฟลว์ Google Workspace ฟังก์ชัน input variables จะยอมรับเอาต์พุตวันที่และเวลาจากขั้นตอนอื่นๆ ในโฟลว์
setOnChangeAction(action)DateTimePickerตั้งค่า Action ที่สคริปต์จะดำเนินการเมื่อใดก็ตามที่อินพุตของเครื่องมือเลือกมีการเปลี่ยนแปลง
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerกำหนดจำนวนนาทีที่ควรชดเชยเขตเวลาจาก UTC
setTitle(title)DateTimePickerกำหนดชื่อที่แสดงเหนือช่องป้อนข้อมูล
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerกำหนดค่าที่กรอกไว้ล่วงหน้าที่จะตั้งค่าในช่องป้อนข้อมูล
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerกำหนดค่าที่กรอกไว้ล่วงหน้าที่จะตั้งค่าในช่องป้อนข้อมูล

เอกสารโดยละเอียด

setFieldName(fieldName)

กำหนดชื่อฟิลด์ที่ระบุเครื่องมือเลือกนี้ในออบเจ็กต์เหตุการณ์ที่สร้างขึ้นเมื่อมีการโต้ตอบ UI ผู้ใช้จะเห็นชื่อฟิลด์ ต้องระบุ ชื่อฟิลด์ที่ระบุต้องไม่ซ้ำกัน

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fieldNameStringชื่อที่จะกำหนดให้กับอินพุตนี้

รีเทิร์น

DateTimePicker — เครื่องมือเลือกนี้สำหรับการเชื่อมโยง


setHostAppDataSource(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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
hostAppDataSourceHostAppDataSourceแหล่งข้อมูล

รีเทิร์น

DateTimePicker — เครื่องมือเลือกนี้สำหรับการเชื่อมโยง


setOnChangeAction(action)

ตั้งค่า Action ที่สคริปต์จะดำเนินการเมื่อใดก็ตามที่อินพุตของเครื่องมือเลือกมีการเปลี่ยนแปลง

พารามิเตอร์

ชื่อประเภทคำอธิบาย
actionActionการดำเนินการที่ต้องทำ

รีเทิร์น

DateTimePicker — เครื่องมือเลือกนี้สำหรับการเชื่อมโยง


setTimeZoneOffsetInMins(timeZoneOffsetMins)

กำหนดจำนวนนาทีที่ควรชดเชยเขตเวลาจาก UTC หากตั้งค่าไว้ ระบบจะแสดงวันที่และเวลาในเขตเวลาที่ระบุ หากไม่ได้ตั้งค่าไว้ ระบบจะแสดงเวลาในเขตเวลาของผู้ใช้

พารามิเตอร์

ชื่อประเภทคำอธิบาย
timeZoneOffsetMinsIntegerจำนวนนาทีที่เขตเวลาออฟเซ็ตจาก UTC

รีเทิร์น

DateTimePicker — เครื่องมือเลือกนี้สำหรับการเชื่อมโยง


setTitle(title)

กำหนดชื่อที่แสดงเหนือช่องป้อนข้อมูล

พารามิเตอร์

ชื่อประเภทคำอธิบาย
titleStringชื่อช่องป้อนข้อมูล

รีเทิร์น

DateTimePicker — เครื่องมือเลือกนี้สำหรับการเชื่อมโยง


setValueInMsSinceEpoch(valueMsEpoch)

กำหนดค่าที่กรอกไว้ล่วงหน้าที่จะตั้งค่าในช่องป้อนข้อมูล

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valueMsEpochNumberค่าเริ่มต้นที่ป้อนเป็นตัวเลขในหน่วยมิลลิวินาทีตั้งแต่ Epoch โดยจะแสดงเป็นสตริงในพารามิเตอร์การเรียกกลับของแบบฟอร์มเสมอ

รีเทิร์น

DateTimePicker — เครื่องมือเลือกนี้สำหรับการเชื่อมโยง


setValueInMsSinceEpoch(valueMsEpoch)

กำหนดค่าที่กรอกไว้ล่วงหน้าที่จะตั้งค่าในช่องป้อนข้อมูล

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valueMsEpochStringค่าเริ่มต้นที่วางไว้ในอินพุตเป็นสตริงในหน่วยมิลลิวินาทีตั้งแต่ Epoch โดยจะแสดงเป็นสตริงในพารามิเตอร์การเรียกกลับของแบบฟอร์มเสมอ

รีเทิร์น

DateTimePicker — เครื่องมือเลือกนี้สำหรับการเชื่อมโยง