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 |
|---|---|---|
add | Widget | Ajoute l'action d'événement qui peut être effectuée sur le widget. |
set | Date | 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. |
set | Date | Dans un agent Google Workspace Studio, les variables d'entrée acceptent les sorties de date et heure provenant d'autres étapes de l'agent. |
set | Widget | Définit l'ID unique attribué qui est utilisé pour identifier le widget à modifier. |
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. |
set | Widget | Définit la visibilité du widget. |
Documentation détaillée
add
Ajoute l'action d'événement qui peut être effectuée sur le widget.
Paramètres
| Nom | Type | Description |
|---|---|---|
event | Event | Event à ajouter. |
Renvois
Widget : objet pour le chaînage.
set
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
| Nom | Type | Description |
|---|---|---|
field | String | Nom à attribuer à cette entrée. |
Renvois
Date : ce sélecteur, pour le chaînage.
set
Dans un agent Google Workspace Studio, les variables d'entrée acceptent les sorties de date et 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
| Nom | Type | Description |
|---|---|---|
host | Host | Source de données. |
Renvois
Date : ce sélecteur, pour le chaînage.
set
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
| Nom | Type | Description |
|---|---|---|
id | String | ID du widget, limité à 64 caractères et au format `[a-zA-Z0-9-]+`. |
Renvois
Widget : cet objet, 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.
set
Définit la visibilité du widget. La valeur par défaut est "VISIBLE".
Paramètres
| Nom | Type | Description |
|---|---|---|
visibility | Visibility | Le Visibility du widget. |
Renvois
Widget : objet pour le chaînage.