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önderim 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öntem | Dönüş türü | Kısa açıklama |
---|---|---|
set | Date | Kullanıcı arayüzü etkileşimi olduğunda oluşturulan etkinlik nesnesinde bu seçiciyi tanımlayan alan adını ayarlar. |
set | Date | Seçici girişi her değiştiğinde komut dosyasının gerçekleştireceği bir Action ayarlar. |
set | Date | Saat diliminin UTC'den ne kadar uzakta olması gerektiğini belirler. |
set | Date | Giriş alanının üzerinde görüntülenen başlığı ayarlar. |
set | Date | Giriş alanına ayarlanacak önceden doldurulmuş değeri ayarlar. |
set | Date | Giriş alanına ayarlanacak önceden doldurulmuş değeri ayarlar. |
Ayrıntılı dokümanlar
setFieldName(fieldName)
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
Ad | Tür | Açıklama |
---|---|---|
field | String | Bu girişe atanacak ad. |
Return
Date
: Zincirleme için bu seçici.
setOnChangeAction(action)
Seçici girişi her değiştiğinde komut dosyasının gerçekleştireceği bir Action
ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
action | Action | Yapılacak işlem. |
Return
Date
: Zincirleme için bu seçici.
setTimeZoneOffsetInMins(timeZoneOffsetMins)
Saat diliminin UTC'den ne kadar uzakta olması gerektiğini belirler. Ayarlanırsa tarih ve saat, belirtilen saat diliminde gösterilir. Ayarlanmazsa saat, kullanıcının saat diliminde gösterilir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
time | Integer | Saat diliminin UTC'den saat farkının dakika cinsinden değeri. |
Return
Date
: Zincirleme için bu seçici.
setTitle(title)
Giriş alanının üzerinde görüntülenen başlığı ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
title | String | Giriş alanı başlığı. |
Return
Date
: Zincirleme için bu seçici.
setValueInMsSinceEpoch(valueMsEpoch)
Giriş alanına ayarlanacak önceden doldurulmuş değeri ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
value | Number | Giriş alanına sayı olarak yerleştirilen varsayılan değer (epoch'tan beri geçen milisaniye cinsinden). Form geri çağırma parametrelerinde her zaman dize olarak temsil edilir. |
Return
Date
: Zincirleme için bu seçici.
setValueInMsSinceEpoch(valueMsEpoch)
Giriş alanına ayarlanacak önceden doldurulmuş değeri ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
value | String | Giriş alanına dize olarak yerleştirilen varsayılan değer (epoch'tan beri geçen milisaniye cinsinden). Form geri çağırma parametrelerinde her zaman dize olarak temsil edilir. |
Return
Date
: Zincirleme için bu seçici.