Champ de saisie permettant aux utilisateurs de saisir une date et une heure.
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é lors d'une interaction avec l'interface utilisateur. |
setOnChangeAction(action) | DateTimePicker | Définit un Action que le script effectue chaque fois que l'entrée du sélecteur change. |
setTimeZoneOffsetInMins(timeZoneOffsetMins) | DateTimePicker | Définit le nombre de minutes pendant lesquelles le fuseau horaire doit être décalé par rapport à 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é lors d'une interaction avec l'interface utilisateur. L'utilisateur peut voir le nom du champ. Obligatoire. Le nom de champ spécifié doit être unique.
Paramètres
| Nom | Type | Description |
|---|---|---|
fieldName | String | Nom à attribuer à cette entrée. |
Aller-retour
DateTimePicker : sélecteur pour le chaînage.
setOnChangeAction(action)
Définit un Action que le script effectue chaque fois que l'entrée du sélecteur change.
Paramètres
| Nom | Type | Description |
|---|---|---|
action | Action | Action à effectuer. |
Aller-retour
DateTimePicker : sélecteur pour le chaînage.
setTimeZoneOffsetInMins(timeZoneOffsetMins)
Définit le nombre de minutes pendant lesquelles le fuseau horaire doit être décalé par rapport à l'heure UTC. Si elle 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 |
|---|---|---|
timeZoneOffsetMins | Integer | Nombre de minutes de décalage horaire par rapport au fuseau UTC. |
Aller-retour
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. |
Aller-retour
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'époque. Elle est toujours représentée par une chaîne dans les paramètres de rappel du formulaire. |
Aller-retour
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 en tant que chaîne, en millisecondes écoulées depuis l'époque. Elle est toujours représentée par une chaîne dans les paramètres de rappel du formulaire. |
Aller-retour
DateTimePicker : sélecteur pour le chaînage.