Class TimePicker

TimePicker

Champ de saisie permettant 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éthodeType renvoyéBrève description
addEventAction(eventAction)WidgetAjoute l'action d'événement qui peut être effectuée sur le widget.
setFieldName(fieldName)TimePickerDéfinit le nom du champ qui identifie ce sélecteur dans l'objet d'événement généré lors d'une interaction avec l'UI.
setHours(hours)TimePickerDéfinit la valeur des heures préremplies à définir dans le champ de saisie.
setId(id)WidgetDéfinit l'ID unique attribué qui est utilisé pour identifier le widget à modifier.
setMinutes(minutes)TimePickerDéfinit la valeur en minutes préremplie dans le champ de saisie.
setOnChangeAction(action)TimePickerDéfinit un Action que le script exécute chaque fois que l'entrée du sélecteur change.
setTitle(title)TimePickerDéfinit le titre affiché au-dessus du champ de saisie.
setVisibility(visibility)WidgetDé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

NomTypeDescription
eventActionEventActionEventAction à ajouter.

Renvois

Widget : 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é lors d'une interaction avec l'UI. Le nom du champ est visible par l'utilisateur. Obligatoire : le nom de champ spécifié doit être unique.

Paramètres

NomTypeDescription
fieldNameStringNom à attribuer à cette entrée.

Renvois

TimePicker : ce sélecteur, pour le chaînage.


setHours(hours)

Définit la valeur des heures préremplies à définir dans le champ de saisie.

Paramètres

NomTypeDescription
hoursIntegerLa valeur d'heure par défaut placée dans le champ de saisie est comprise entre 0 et 23. Il est toujours représenté sous la forme d'une chaîne dans les paramètres de rappel du 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 mutation de widget n'est disponible que dans les modules complémentaires.

Paramètres

NomTypeDescription
idStringID 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 en minutes préremplie dans le champ de saisie.

Paramètres

NomTypeDescription
minutesIntegerLa valeur par défaut des minutes saisie dans le champ d'entrée est comprise entre 0 et 59. Il est toujours représenté sous la forme d'une chaîne dans les paramètres de rappel du formulaire.

Renvois

TimePicker : ce sélecteur, pour le chaînage.


setOnChangeAction(action)

Définit un Action que le script exécute chaque fois que l'entrée du sélecteur change.

Paramètres

NomTypeDescription
actionActionAction à 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

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

NomTypeDescription
visibilityVisibilityLe Visibility du widget.

Renvois

Widget : objet pour le chaînage.