Champ de saisie permettant aux utilisateurs de saisir une date et une heure.
Compatible avec la validation de l'envoi de formulaires. 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éthode | Type renvoyé | Brève description |
|---|---|---|
set | Date | 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. |
set | Date | Dans un flux Google Workspace, les variables d'entrée acceptent les sorties de date et heure des autres étapes du flux. |
set | Date | Définit un Action que le script exécute chaque fois que l'entrée du sélecteur change. |
set | Date | Définit le nombre de minutes de décalage du fuseau horaire par rapport à l'heure UTC. |
set | Date | Définit le titre affiché au-dessus du champ de saisie. |
set | Date | Définit la valeur préremplie à définir dans le champ de saisie. |
set | Date | Définit la valeur préremplie à définir dans le champ de saisie. |
Documentation détaillée
set
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
| Nom | Type | Description |
|---|---|---|
field | String | Nom à attribuer à cette entrée. |
Renvois
Date : ce sélecteur, pour le chaînage.
set
Dans un flux Google Workspace, les variables d'entrée acceptent les sorties de date et heure des autres étapes du flux. Par exemple, recevez l'heure à laquelle un message Gmail a été envoyé ou la date à laquelle un événement Agenda est prévu.
Disponible uniquement dans le programme Gemini Alpha pour les modules complémentaires Google Workspace qui étendent les flux Google Workspace.
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
| Nom | Type | Description |
|---|---|---|
host | Host | Source de données. |
Renvois
Date : ce sélecteur, pour le chaînage.
set
Définit un Action que le script exécute chaque fois que l'entrée du sélecteur change.
Paramètres
| Nom | Type | Description |
|---|---|---|
action | Action | Action à effectuer. |
Renvois
Date : ce sélecteur, pour le chaînage.
set
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
| Nom | Type | Description |
|---|---|---|
time | Integer | Nombre de minutes de décalage du fuseau horaire par rapport à UTC. |
Renvois
Date : ce sélecteur, pour le chaînage.
set
Définit le titre affiché au-dessus du champ de saisie.
Paramètres
| Nom | Type | Description |
|---|---|---|
title | String | Titre du champ de saisie. |
Renvois
Date : ce sélecteur, pour le chaînage.
set
Définit la valeur préremplie à définir dans le champ de saisie.
Paramètres
| Nom | Type | Description |
|---|---|---|
value | Number | Valeur 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
Date : ce sélecteur, pour le chaînage.
set
Définit la valeur préremplie à définir dans le champ de saisie.
Paramètres
| Nom | Type | Description |
|---|---|---|
value | String | Valeur 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
Date : ce sélecteur, pour le chaînage.