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
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 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.
setOnChangeAction(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.
setTimeZoneOffsetInMins(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.
setTitle(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.
setValueInMsSinceEpoch(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.
setValueInMsSinceEpoch(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.