Champ de saisie permettant aux utilisateurs de saisir une date et une heure.
Prend en charge 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 | 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'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 Field Name(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 du champ spécifié doit être unique.
Paramètres
| Nom | Type | Description |
|---|---|---|
field | String | Nom à attribuer à cette entrée. |
Renvois
Date : sélecteur pour le chaînage.
set On Change Action(action)
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 : sélecteur pour le chaînage.
set Time Zone Offset In Mins(timeZoneOffsetMins)
Définit le nombre de minutes de décalage du fuseau horaire par rapport à l'UTC. Si ce champ est défini, la date et l'heure s'affichent 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 : sélecteur pour le chaînage.
set Title(title)
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 : sélecteur pour le chaînage.
set Value In Ms Since Epoch(valueMsEpoch)
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 la forme d'un 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 : sélecteur pour le chaînage.
set Value In Ms Since Epoch(valueMsEpoch)
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 : sélecteur pour le chaînage.