Class DatePicker

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

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

พร้อมให้บริการสำหรับส่วนเสริมของ Google Workspace และแอป 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'),
        );

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
addEventAction(eventAction)Widgetเพิ่มการดำเนินการของเหตุการณ์ที่ทำได้ในวิดเจ็ต
setFieldName(fieldName)DatePickerกำหนดชื่อฟิลด์ที่ระบุเครื่องมือเลือกนี้ในออบเจ็กต์เหตุการณ์ที่สร้างขึ้นเมื่อมีการโต้ตอบ UI
setId(id)Widgetกำหนดรหัสที่ไม่ซ้ำกันที่กำหนดให้ซึ่งใช้ระบุวิดเจ็ตที่จะเปลี่ยน
setOnChangeAction(action)DatePickerตั้งค่า Action ที่สคริปต์จะดำเนินการเมื่อใดก็ตามที่อินพุตของเครื่องมือเลือกมีการเปลี่ยนแปลง
setTitle(title)DatePickerกำหนดชื่อที่แสดงเหนือช่องป้อนข้อมูล
setValueInMsSinceEpoch(valueMsEpoch)DatePickerกำหนดค่าที่กรอกไว้ล่วงหน้าที่จะตั้งค่าในช่องป้อนข้อมูล
setValueInMsSinceEpoch(valueMsEpoch)DatePickerกำหนดค่าที่กรอกไว้ล่วงหน้าที่จะตั้งค่าในช่องป้อนข้อมูล
setVisibility(visibility)Widgetตั้งค่าระดับการมองเห็นของวิดเจ็ต

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

addEventAction(eventAction)

เพิ่มการดำเนินการของเหตุการณ์ที่ทำได้ในวิดเจ็ต

พารามิเตอร์

ชื่อประเภทคำอธิบาย
eventActionEventActionEventAction ที่จะเพิ่ม

รีเทิร์น

Widget — ออบเจ็กต์สำหรับการเชื่อมโยง


setFieldName(fieldName)

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

พารามิเตอร์

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

รีเทิร์น

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


setId(id)

กำหนดรหัสที่ไม่ซ้ำกันที่กำหนดให้ซึ่งใช้ระบุวิดเจ็ตที่จะเปลี่ยน การเปลี่ยนแปลงวิดเจ็ต รองรับเฉพาะในส่วนเสริม

พารามิเตอร์

ชื่อประเภทคำอธิบาย
idStringรหัสของวิดเจ็ต โดยมีความยาวได้ไม่เกิน 64 อักขระและอยู่ในรูปแบบ `[a-zA-Z0-9-]+`

รีเทิร์น

Widget - ออบเจ็กต์นี้สำหรับการเชื่อมโยง


setOnChangeAction(action)

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

พารามิเตอร์

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

รีเทิร์น

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


setTitle(title)

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

พารามิเตอร์

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

รีเทิร์น

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


setValueInMsSinceEpoch(valueMsEpoch)

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

พารามิเตอร์

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

รีเทิร์น

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


setValueInMsSinceEpoch(valueMsEpoch)

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

พารามิเตอร์

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

รีเทิร์น

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


setVisibility(visibility)

ตั้งค่าระดับการมองเห็นของวิดเจ็ต ค่าเริ่มต้นคือ `VISIBLE`

พารามิเตอร์

ชื่อประเภทคำอธิบาย
visibilityVisibilityVisibility ของวิดเจ็ต

รีเทิร์น

Widget — ออบเจ็กต์สำหรับการเชื่อมโยง