Class DatePicker

DatePicker

Champ de saisie qui permet de saisir une date.

Disponible pour les modules complémentaires Google Workspace et les applications Google Chat.

const dateTimePicker =
    CardService.newDatePicker()
        .setTitle('Enter the date.')
        .setFieldName('date_field')
        // Set default value as Jan 1, 2018 UTC. Either a number or string is
        // acceptable.
        .setValueInMsSinceEpoch(1514775600)
        .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)DatePickerDé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.
setId(id)WidgetDéfinit l'ID unique attribué qui est utilisé pour identifier le widget à modifier.
setOnChangeAction(action)DatePickerDéfinit une Action que le script effectue chaque fois que l'entrée du sélecteur change.
setTitle(title)DatePickerDéfinit le titre affiché au-dessus du champ de saisie.
setValueInMsSinceEpoch(valueMsEpoch)DatePickerDéfinit la valeur préremplie à définir dans le champ de saisie.
setValueInMsSinceEpoch(valueMsEpoch)DatePickerDéfinit la valeur préremplie à définir dans le 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

DatePicker : 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, avec une limite de 64 caractères et au format `[a-zA-Z0-9-]+`.

Renvois

Widget : cet objet, 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

DatePicker : 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

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


setValueInMsSinceEpoch(valueMsEpoch)

Définit la valeur préremplie à définir dans le champ de saisie.

Paramètres

NomTypeDescription
valueMsEpochNumberValeur par défaut placée dans l'entrée sous forme de nombre, en millisecondes depuis l'epoch. Seule la date de l'heure de l'epoch est utilisée, et l'heure de l'epoch est ignorée. Elle est toujours représentée sous forme de chaîne dans les paramètres de rappel de formulaire.

Renvois

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


setValueInMsSinceEpoch(valueMsEpoch)

Définit la valeur préremplie à définir dans le champ de saisie.

Paramètres

NomTypeDescription
valueMsEpochStringValeur par défaut placée dans l'entrée sous forme de chaîne, en millisecondes depuis l'epoch. Seule la date de l'heure de l'epoch est utilisée, et l'heure de l'epoch est ignorée. Elle est toujours représentée sous forme de chaîne dans les paramètres de rappel de formulaire.

Renvois

DatePicker : 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.