Class DateTimePicker

Outil de sélection de la date et de l'heure

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éthodeType renvoyéBrève description
setFieldName(fieldName)DateTimePickerDé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)DateTimePickerDéfinit un Action que le script effectue chaque fois que l'entrée du sélecteur change.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerDéfinit le nombre de minutes pendant lesquelles le fuseau horaire doit être décalé par rapport à l'heure UTC.
setTitle(title)DateTimePickerDéfinit le titre affiché au-dessus du champ de saisie.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerDéfinit la valeur préremplie à définir dans le champ de saisie.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerDé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

NomTypeDescription
fieldNameStringNom à 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

NomTypeDescription
actionActionAction à 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

NomTypeDescription
timeZoneOffsetMinsIntegerNombre 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

NomTypeDescription
titleStringTitre 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

NomTypeDescription
valueMsEpochNumberValeur 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

NomTypeDescription
valueMsEpochStringValeur 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.