Champ de saisie qui permet aux utilisateurs de saisir une heure.
Disponible pour les modules complémentaires Google Workspace et les applications Google Chat.
const dateTimePicker = CardService.newTimePicker() .setTitle('Enter the time.') .setFieldName('time_field') // Set default value as 3:30 AM. .setHours(3) .setMinutes(30) .setOnChangeAction( CardService.newAction().setFunctionName('handleDateTimeChange'), );
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
add | Widget | Ajoute l'action d'événement qui peut être effectuée sur le widget. |
set | Time | Définit le nom du champ qui identifie ce sélecteur dans l'objet d'événement généré en cas d'interaction avec l'interface utilisateur. |
set | Time | Définit la valeur d'heure préremplie à définir dans le champ de saisie. |
set | Widget | Définit l'ID unique attribué qui est utilisé pour identifier le widget à modifier. |
set | Time | Définit la valeur de minute préremplie à définir dans le champ de saisie. |
set | Time | Définit une Action que le script effectue chaque fois que l'entrée du sélecteur change. |
set | Time | Définit le titre affiché au-dessus du champ de saisie. |
set | Widget | Définit la visibilité du widget. |
Documentation détaillée
addEventAction(eventAction)
Ajoute l'action d'événement qui peut être effectuée sur le widget.
Paramètres
| Nom | Type | Description |
|---|---|---|
event | Event | Le Event à ajouter. |
Renvois
Widget : l'objet, pour le chaînage.
setFieldName(fieldName)
Définit le nom du champ qui identifie ce sélecteur dans l'objet d'événement généré en cas d'interaction avec l'interface utilisateur. Le nom du champ est visible par l'utilisateur. Obligatoire : le nom de champ spécifié doit être unique.
Paramètres
| Nom | Type | Description |
|---|---|---|
field | String | Nom à attribuer à cette entrée. |
Renvois
TimePicker : ce sélecteur, pour le chaînage.
setHours(hours)
Définit la valeur d'heure préremplie à définir dans le champ de saisie.
Paramètres
| Nom | Type | Description |
|---|---|---|
hours | Integer | Valeur d'heure par défaut placée dans l'entrée, comprise entre 0 et 23. Elle est toujours représentée sous forme de chaîne dans les paramètres de rappel de formulaire. |
Renvois
TimePicker : ce sélecteur, pour le chaînage.
setId(id)
Définit l'ID unique attribué qui est utilisé pour identifier le widget à modifier. La modification des widgets n'est possible que dans les modules complémentaires.
Paramètres
| Nom | Type | Description |
|---|---|---|
id | String | ID du widget, limité à 64 caractères et au format `[a-zA-Z0-9-]+`. |
Renvois
Widget : cet objet, pour le chaînage.
setMinutes(minutes)
Définit la valeur de minute préremplie à définir dans le champ de saisie.
Paramètres
| Nom | Type | Description |
|---|---|---|
minutes | Integer | Valeur de minute par défaut placée dans l'entrée, comprise entre 0 et 59. Elle est toujours représentée sous forme de chaîne dans les paramètres de rappel de formulaire. |
Renvois
TimePicker : ce sélecteur, pour le chaînage.
setOnChangeAction(action)
Définit une Action que le script effectue chaque fois que l'entrée du sélecteur change.
Paramètres
| Nom | Type | Description |
|---|---|---|
action | Action | Action à effectuer. |
Renvois
TimePicker : ce sélecteur, pour le chaînage.
setTitle(title)
Définit le titre affiché au-dessus du champ de saisie.
Paramètres
| Nom | Type | Description |
|---|---|---|
title | String | Titre du champ de saisie. |
Renvois
TimePicker : ce sélecteur, pour le chaînage.
setVisibility(visibility)
Définit la visibilité du widget. La valeur par défaut est `VISIBLE`.
Paramètres
| Nom | Type | Description |
|---|---|---|
visibility | Visibility | Visibility du widget. |
Renvois
Widget : l'objet, pour le chaînage.