Class DateTimePicker

DateTimePicker

Champ de saisie permettant aux utilisateurs de saisir une date et une heure.

La validation de l'envoi de formulaires est acceptée. Lorsque Action.setAllWidgetsAreRequired(allWidgetsAreRequired) est défini sur true ou que ce widget est spécifié via Action.addRequiredWidget(requiredWidget), l'action d'envoi est bloquée, sauf si une valeur est sélectionnée.

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

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'),
        );

Méthodes

MéthodeType renvoyéBrève description
addEventAction(eventAction)WidgetAjoute l'action d'événement pouvant être effectuée sur le widget.
setFieldName(fieldName)DateTimePickerDé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'UI.
setHostAppDataSource(hostAppDataSource)DateTimePickerDans un agent Google Workspace Studio, les variables d'entrée acceptent les sorties de date et d'heure provenant d'autres étapes de l'agent.
setId(id)WidgetDéfinit l'ID unique attribué qui est utilisé pour identifier le widget à modifier.
setOnChangeAction(action)DateTimePickerDéfinit un Action que le script exécute chaque fois que l'entrée du sélecteur change.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerDéfinit le nombre de minutes de décalage du fuseau horaire par rapport à l'heure UTC.
setTitle(title)DateTimePickerDéfinit le titre affiché au-dessus du champ de saisie.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerDéfinit la valeur préremplie à définir dans le champ de saisie.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerDé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 pouvant ê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é en cas d'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

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

setHostAppDataSource(hostAppDataSource)

Dans un agent Google Workspace Studio, les variables d'entrée acceptent les sorties de date et d'heure provenant d'autres étapes de l'agent. Par exemple, recevez l'heure à laquelle un message Gmail a été envoyé ou la date à laquelle un événement Agenda est prévu.

Uniquement disponible pour les modules complémentaires Google Workspace qui étendent Google Workspace Studio. 

const workflowDataSource =
    CardService.newWorkflowDataSource().setIncludeVariables(true);

const hostAppDataSource =
    CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource);

const dateTimePicker = CardService.newDateTimePicker()
                          .setTitle('Enter the date and time.')
                          .setFieldName('date_time_field')
                          .setHostAppDataSource(hostAppDataSource);

Paramètres

NomTypeDescription
hostAppDataSourceHostAppDataSourceSource de données.

Renvois

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

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

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

setTimeZoneOffsetInMins(timeZoneOffsetMins)

Définit le nombre de minutes de décalage du fuseau horaire par rapport à l'heure UTC. Si cette option est définie, la date et l'heure sont affichées dans le fuseau horaire spécifié. Si ce champ n'est pas défini, l'heure est affichée dans le fuseau horaire de l'utilisateur.

Paramètres

NomTypeDescription
timeZoneOffsetMinsIntegerNombre de minutes de décalage du fuseau horaire par rapport à UTC.

Renvois

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

DateTimePicker : 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. Il est toujours représenté sous forme de chaîne dans les paramètres de rappel du formulaire.

Renvois

DateTimePicker : 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. Il est toujours représenté sous forme de chaîne dans les paramètres de rappel du formulaire.

Renvois

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