Class TimePicker

TimePicker

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é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é en cas d'interaction avec l'interface utilisateur.
setHours(hours)TimePickerDéfinit la valeur d'heure préremplie à 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 de minute préremplie à définir dans le champ de saisie.
setOnChangeAction(action)TimePickerDéfinit une Action que le script effectue 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
eventActionEventActionLe EventAction à 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

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

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

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 de minute préremplie à définir dans le champ de saisie.

Paramètres

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

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
visibilityVisibilityVisibility du widget.

Renvois

Widget : l'objet, pour le chaînage.