Class DateTimePicker

DateTimePicker

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

Form gönderimi doğrulamasını 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
addEventAction(eventAction)WidgetWidget'ta gerçekleştirilebilecek etkinlik işlemini ekler.
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 Studio aracısında, input variables'ın (giriş değişkenleri) aracıdaki diğer adımlardan gelen tarih ve saat çıkışlarını kabul etmesine izin verilir.
setId(id)WidgetDeğiştirilecek widget'ı tanımlamak için kullanılan benzersiz kimliği ayarlar.
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.
setVisibility(visibility)WidgetWidget'ın görünürlüğünü ayarlar.

Ayrıntılı belgeler

addEventAction(eventAction)

Widget'ta gerçekleştirilebilecek etkinlik işlemini ekler.

Parametreler

AdTürAçıklama
eventActionEventActionEklenecek EventAction.

Return

Widget: Zincirleme için kullanılan Nesne.

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ıya görünür. 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 Studio aracısında, input variables'ın (giriş değişkenleri) aracıdaki diğer adımlardan gelen tarih ve saat çıkışlarını kabul etmesine izin verilir. Örneğin, bir Gmail iletisinin gönderildiği saati veya bir takvim etkinliğinin planlandığı tarihi alabilirsiniz.

Yalnızca Google Workspace Studio'yu genişleten Google Workspace eklentileri için 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.

setId(id)

Değiştirilecek widget'ı tanımlamak için kullanılan benzersiz kimliği ayarlar. Widget mutasyonu yalnızca eklentilerde desteklenir.

Parametreler

AdTürAçıklama
idString64 karakterle sınırlı ve `[a-zA-Z0-9-]+` biçiminde olan widget'ın kimliği.

Return

Widget: Zincirleme için kullanılan bu nesne.

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.

setVisibility(visibility)

Widget'ın görünürlüğünü ayarlar. Varsayılan değer "VISIBLE"dır.

Parametreler

AdTürAçıklama
visibilityVisibilityWidget'ın Visibility.

Return

Widget: Zincirleme için kullanılan Nesne.