Un champ de saisie qui permet aux utilisateurs de saisir une date et une heure.
Disponible avec les modules complémentaires Google Workspace et les applications Google Chat
var 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 |
|---|---|---|
setFieldName(fieldName) | DateTimePicker | Définit le nom de champ qui identifie ce sélecteur dans l'objet d'événement généré en cas d'interaction avec l'interface utilisateur. |
setOnChangeAction(action) | DateTimePicker | Définit une Action que le script exécute chaque fois que l'entrée du sélecteur change. |
setTimeZoneOffsetInMins(timeZoneOffsetMins) | DateTimePicker | Définit le nombre de minutes de décalage entre le fuseau horaire et l'heure UTC. |
setTitle(title) | DateTimePicker | Définit le titre affiché au-dessus du champ de saisie. |
setValueInMsSinceEpoch(valueMsEpoch) | DateTimePicker | Définit la valeur préremplie à définir dans le champ de saisie. |
setValueInMsSinceEpoch(valueMsEpoch) | DateTimePicker | Définit la valeur préremplie à définir dans le champ de saisie. |
Documentation détaillée
setFieldName(fieldName)
Définit le nom de champ qui identifie ce sélecteur dans l'objet d'événement généré en cas d'interaction avec l'interface utilisateur. Le nom du champ est visible par l'utilisateur. Obligatoire. Le nom de champ spécifié doit être unique.
Paramètres
| Nom | Type | Description |
|---|---|---|
fieldName | String | Nom à attribuer à cette entrée. |
Renvois
DateTimePicker : sélecteur, pour le chaînage.
setOnChangeAction(action)
Définit une 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
DateTimePicker : sélecteur, pour le chaînage.
setTimeZoneOffsetInMins(timeZoneOffsetMins)
Définit le nombre de minutes de décalage entre le fuseau horaire et l'heure UTC. Si cette option est définie, la date et l'heure s'affichent dans le fuseau horaire spécifié. Si cette règle n'est pas configurée, l'heure est affichée dans le fuseau horaire de l'utilisateur.
Paramètres
| Nom | Type | Description |
|---|---|---|
timeZoneOffsetMins | Integer | Nombre de minutes de décalage du fuseau horaire par rapport à l'UTC. |
Renvois
DateTimePicker : 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
DateTimePicker : 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 |
|---|---|---|
valueMsEpoch | 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
DateTimePicker : 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 |
|---|---|---|
valueMsEpoch | 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
DateTimePicker : sélecteur, pour le chaînage.