Class DateTimePicker

DateTimePicker

Kullanıcıların tarih ve saat girebilmesine olanak tanıyan bir giriş alanı.

Form gönderimi doğrulamayı destekler. Action.setAllWidgetsAreRequired(allWidgetsAreRequired), true olarak ayarlandığında veya bu widget Action.addRequiredWidget(requiredWidget) aracılığıyla belirtildiğinde, bir değer seçilmediği sürece gönderme işlemi engellenir.

Google Workspace eklentileri ve Google Chat uygulamaları için kullanılabilir. 

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

Yöntemler

YöntemDönüş türüKısa açıklama
setFieldName(fieldName)DateTimePickerBir kullanıcı arayüzü etkileşimi olduğunda oluşturulan etkinlik nesnesinde bu seçiciyi tanımlayan alan adını ayarlar.
setHostAppDataSource(hostAppDataSource)DateTimePickerGoogle Workspace akışında, giriş değişkenlerinin akıştaki diğer adımlardan tarih ve saat çıkışlarını kabul etmesini sağlar.
setOnChangeAction(action)DateTimePickerSeçici girişi her değiştiğinde komut dosyasının gerçekleştirdiği bir Action ayarlar.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerSaat diliminin UTC'den kaç dakika farklı olması gerektiğini ayarlar.
setTitle(title)DateTimePickerGiriş alanının üzerinde gösterilen başlığı ayarlar.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerGiriş alanında ayarlanacak önceden doldurulmuş değeri belirler.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerGiriş alanında ayarlanacak önceden doldurulmuş değeri belirler.

Ayrıntılı belgeler

setFieldName(fieldName)

Bir kullanıcı arayüzü etkileşimi olduğunda oluşturulan etkinlik nesnesinde bu seçiciyi tanımlayan alan adını ayarlar. Alan adı kullanıcı tarafından görülebilir. Zorunlu. Belirtilen alan adı benzersiz olmalıdır.

Parametreler

AdTürAçıklama
fieldNameStringBu girişe atanacak ad.

Return

DateTimePicker: Zincirleme için kullanılan bu seçici.

setHostAppDataSource(hostAppDataSource)

Google Workspace akışında, giriş değişkenlerinin akıştaki diğer adımlardan tarih ve saat çıkışlarını kabul etmesini sağlar. Örneğin, bir Gmail iletisinin gönderildiği saati veya bir takvim etkinliğinin planlandığı tarihi alabilirsiniz.

Yalnızca Google Workspace akışlarını genişleten Google Workspace eklentileri için Gemini Alpha programı üzerinden kullanılabilir. 

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

Parametreler

AdTürAçıklama
hostAppDataSourceHostAppDataSourceVeri kaynağı.

Return

DateTimePicker: Zincirleme için kullanılan bu seçici.

setOnChangeAction(action)

Seçici girişi her değiştiğinde komut dosyasının gerçekleştirdiği bir Action ayarlar.

Parametreler

AdTürAçıklama
actionActionYapılacak işlem.

Return

DateTimePicker: Zincirleme için kullanılan bu seçici.

setTimeZoneOffsetInMins(timeZoneOffsetMins)

Saat diliminin UTC'den kaç dakika farklı olması gerektiğini ayarlar. Ayarlanmışsa tarih ve saat, belirtilen saat diliminde gösterilir. Ayarlanmamışsa saat, kullanıcının saat diliminde gösterilir.

Parametreler

AdTürAçıklama
timeZoneOffsetMinsIntegerSaat diliminin UTC'den kaç dakika farklı olduğu.

Return

DateTimePicker: Zincirleme için kullanılan bu seçici.

setTitle(title)

Giriş alanının üzerinde gösterilen başlığı ayarlar.

Parametreler

AdTürAçıklama
titleStringGiriş alanı başlığı.

Return

DateTimePicker: Zincirleme için kullanılan bu seçici.

setValueInMsSinceEpoch(valueMsEpoch)

Giriş alanında ayarlanacak önceden doldurulmuş değeri belirler.

Parametreler

AdTürAçıklama
valueMsEpochNumberGirişe yerleştirilen varsayılan değer, epoch'tan beri geçen milisaniye cinsinden bir sayı olarak. Form geri çağırma parametrelerinde her zaman dize olarak gösterilir.

Return

DateTimePicker: Zincirleme için kullanılan bu seçici.

setValueInMsSinceEpoch(valueMsEpoch)

Giriş alanında ayarlanacak önceden doldurulmuş değeri belirler.

Parametreler

AdTürAçıklama
valueMsEpochStringGirişe dize olarak yerleştirilen varsayılan değer, epoch'tan beri geçen milisaniye cinsinden. Form geri çağırma parametrelerinde her zaman dize olarak gösterilir.

Return

DateTimePicker: Zincirleme için kullanılan bu seçici.