Class DateTimePicker

PemilihTanggalWaktu

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

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

Dokumentasi mendetail

addEventAction(eventAction)

Menambahkan tindakan peristiwa yang dapat dilakukan pada widget.

Parameter

NamaJenisDeskripsi
eventActionEventActionEventAction yang akan ditambahkan.

Pulang pergi

Widget — Objek, untuk pengaitan.

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

NamaJenisDeskripsi
fieldNameStringNama yang akan ditetapkan ke input ini.

Pulang pergi

DateTimePicker — Pemilih ini, untuk pembuatan rantai.

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

NamaJenisDeskripsi
hostAppDataSourceHostAppDataSourceSumber data.

Pulang pergi

DateTimePicker — Pemilih ini, untuk pembuatan rantai.

setId(id)

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

Parameter

NamaJenisDeskripsi
idStringID widget, dengan batas 64 karakter dan dalam format `[a-zA-Z0-9-]+`.

Pulang pergi

Widget — Objek ini, untuk pengaitan.

setOnChangeAction(action)

Menetapkan Action yang dilakukan skrip setiap kali input pemilih berubah.

Parameter

NamaJenisDeskripsi
actionActionTindakan yang harus dilakukan.

Pulang pergi

DateTimePicker — Pemilih ini, untuk pembuatan rantai.

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

NamaJenisDeskripsi
timeZoneOffsetMinsIntegerJumlah menit selisih zona waktu dari UTC.

Pulang pergi

DateTimePicker — Pemilih ini, untuk pembuatan rantai.

setTitle(title)

Menetapkan judul yang ditampilkan di atas kolom input.

Parameter

NamaJenisDeskripsi
titleStringJudul kolom input.

Pulang pergi

DateTimePicker — Pemilih ini, untuk pembuatan rantai.

setValueInMsSinceEpoch(valueMsEpoch)

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

Parameter

NamaJenisDeskripsi
valueMsEpochNumberNilai 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 pembuatan rantai.

setValueInMsSinceEpoch(valueMsEpoch)

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

Parameter

NamaJenisDeskripsi
valueMsEpochStringNilai 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 pembuatan rantai.

setVisibility(visibility)

Menetapkan visibilitas widget. Nilai defaultnya adalah `VISIBLE`.

Parameter

NamaJenisDeskripsi
visibilityVisibilityVisibility widget.

Pulang pergi

Widget — Objek, untuk pengaitan.