Class TimePicker

เครื่องมือเลือกเวลา

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

พร้อมให้บริการสำหรับส่วนเสริมของ Google Workspace และแอป Google Chat

const dateTimePicker =
    CardService.newTimePicker()
        .setTitle('Enter the time.')
        .setFieldName('time_field')
        // Set default value as 3:30 AM.
        .setHours(3)
        .setMinutes(30)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

เมธอด

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

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

addEventAction(eventAction)

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

พารามิเตอร์

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

รีเทิร์น

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


setFieldName(fieldName)

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

พารามิเตอร์

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

รีเทิร์น

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


setHours(hours)

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

พารามิเตอร์

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

รีเทิร์น

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


setId(id)

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

พารามิเตอร์

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

รีเทิร์น

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


setMinutes(minutes)

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

พารามิเตอร์

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

รีเทิร์น

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


setOnChangeAction(action)

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

พารามิเตอร์

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

รีเทิร์น

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


setTitle(title)

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

พารามิเตอร์

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

รีเทิร์น

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


setVisibility(visibility)

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

พารามิเตอร์

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

รีเทิร์น

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