Class DateTimePicker

DateTimePicker

Kolom input yang memungkinkan pengguna memasukkan tanggal dan waktu.

Mendukung validasi pengiriman formulir. Jika Action.setAllWidgetsAreRequired(allWidgetsAreRequired) disetel ke true atau widget ini ditentukan melalui Action.addRequiredWidget(requiredWidget), tindakan pengiriman akan diblokir kecuali jika nilai dipilih.

Tersedia untuk add-on Google Workspace dan aplikasi 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'),
        );

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
addEventAction(eventAction)	Widget	Menambahkan tindakan peristiwa yang dapat dilakukan pada widget.
setFieldName(fieldName)	DateTimePicker	Menetapkan nama kolom yang mengidentifikasi pemilih ini dalam objek peristiwa yang dihasilkan saat ada interaksi UI.
setHostAppDataSource(hostAppDataSource)	DateTimePicker	Di agen Google Workspace Studio, input variables memungkinkan menerima output tanggal dan waktu dari langkah-langkah lain di agen.
setId(id)	Widget	Menetapkan ID unik yang ditetapkan yang digunakan untuk mengidentifikasi widget yang akan diubah.
setOnChangeAction(action)	DateTimePicker	Menetapkan Action yang dilakukan skrip setiap kali input pemilih berubah.
setTimeZoneOffsetInMins(timeZoneOffsetMins)	DateTimePicker	Menetapkan jumlah menit perbedaan waktu zona waktu dari UTC.
setTitle(title)	DateTimePicker	Menetapkan judul yang ditampilkan di atas kolom input.
setValueInMsSinceEpoch(valueMsEpoch)	DateTimePicker	Menetapkan nilai yang telah diisi otomatis untuk ditetapkan di kolom input.
setValueInMsSinceEpoch(valueMsEpoch)	DateTimePicker	Menetapkan nilai yang telah diisi otomatis untuk ditetapkan di kolom input.
setVisibility(visibility)	Widget	Menetapkan visibilitas widget.

Dokumentasi mendetail

addEventAction(eventAction)

Menambahkan tindakan peristiwa yang dapat dilakukan pada widget.

Parameter

Nama	Jenis	Deskripsi
eventAction	EventAction	EventAction yang akan ditambahkan.

Pulang pergi

Widget — Objek, untuk dirangkaikan.

---

setFieldName(fieldName)

Menetapkan nama kolom yang mengidentifikasi pemilih ini dalam objek peristiwa yang dihasilkan saat ada interaksi UI. Nama kolom terlihat oleh pengguna. Wajib; nama kolom yang ditentukan harus unik.

Parameter

Nama	Jenis	Deskripsi
fieldName	String	Nama yang akan ditetapkan ke input ini.

Pulang pergi

DateTimePicker — Pemilih ini, untuk dirangkaikan.

---

setHostAppDataSource(hostAppDataSource)

Di agen Google Workspace Studio, input variables memungkinkan menerima output tanggal dan waktu dari langkah-langkah lain di agen. Misalnya, menerima waktu pesan Gmail dikirim atau tanggal acara kalender dijadwalkan.

Hanya tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio.

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

Parameter

Nama	Jenis	Deskripsi
hostAppDataSource	HostAppDataSource	Sumber data.

Pulang pergi

DateTimePicker — Pemilih ini, untuk dirangkaikan.

---

setId(id)

Menetapkan ID unik yang ditetapkan yang digunakan untuk mengidentifikasi widget yang akan diubah. Mutasi widget hanya didukung di Add-On.

Parameter

Nama	Jenis	Deskripsi
id	String	ID widget, dengan batas 64 karakter dan dalam format `[a-zA-Z0-9-]+`.

Pulang pergi

Widget — Objek ini, untuk dirangkaikan.

---

setOnChangeAction(action)

Menetapkan Action yang dilakukan skrip setiap kali input pemilih berubah.

Parameter

Nama	Jenis	Deskripsi
action	Action	Tindakan yang harus dilakukan.

Pulang pergi

DateTimePicker — Pemilih ini, untuk dirangkaikan.

---

setTimeZoneOffsetInMins(timeZoneOffsetMins)

Menetapkan jumlah menit perbedaan waktu zona waktu dari UTC. Jika disetel, tanggal dan waktu ditampilkan dalam zona waktu yang ditentukan. Jika tidak disetel, waktu akan ditampilkan dalam zona waktu pengguna.

Parameter

Nama	Jenis	Deskripsi
timeZoneOffsetMins	Integer	Jumlah menit offset zona waktu dari UTC.

Pulang pergi

DateTimePicker — Pemilih ini, untuk dirangkaikan.

---

setTitle(title)

Menetapkan judul yang ditampilkan di atas kolom input.

Parameter

Nama	Jenis	Deskripsi
title	String	Judul kolom input.

Pulang pergi

DateTimePicker — Pemilih ini, untuk dirangkaikan.

---

setValueInMsSinceEpoch(valueMsEpoch)

Menetapkan nilai yang telah diisi otomatis untuk ditetapkan di kolom input.

Parameter

Nama	Jenis	Deskripsi
valueMsEpoch	Number	Nilai default yang ditempatkan dalam input sebagai angka, dalam milidetik sejak epoch. Nilai ini selalu ditampilkan sebagai string dalam parameter callback formulir.

Pulang pergi

DateTimePicker — Pemilih ini, untuk dirangkaikan.

---

setValueInMsSinceEpoch(valueMsEpoch)

Menetapkan nilai yang telah diisi otomatis untuk ditetapkan di kolom input.

Parameter

Nama	Jenis	Deskripsi
valueMsEpoch	String	Nilai default yang ditempatkan dalam input sebagai string, dalam milidetik sejak epoch. Nilai ini selalu ditampilkan sebagai string dalam parameter callback formulir.

Pulang pergi

DateTimePicker — Pemilih ini, untuk dirangkaikan.

---

setVisibility(visibility)

Menetapkan visibilitas widget. Nilai defaultnya adalah `VISIBLE`.

Parameter

Nama	Jenis	Deskripsi
visibility	Visibility	Visibility widget.

Pulang pergi

Widget — Objek, untuk dirangkaikan.