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

MetodeJenis hasil yang ditampilkanDeskripsi singkat
setFieldName(fieldName)DateTimePickerMenetapkan nama kolom yang mengidentifikasi pemilih ini dalam objek peristiwa yang dihasilkan saat ada interaksi UI.
setHostAppDataSource(hostAppDataSource)DateTimePickerDalam alur Google Workspace, memungkinkan input variabel menerima output tanggal dan waktu dari langkah-langkah lain dalam alur.
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.

Dokumentasi mendetail

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)

Dalam alur Google Workspace, memungkinkan input variabel menerima output tanggal dan waktu dari langkah-langkah lain dalam alur. Misalnya, menerima waktu pesan Gmail dikirim atau tanggal acara kalender dijadwalkan.

Hanya tersedia melalui program Gemini Alpha untuk add-on Google Workspace yang memperluas Alur Google Workspace. 

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.

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.