Class DateTimePicker

Sélecteur de dateHeure

Champ de saisie permettant aux utilisateurs de saisir une date et une heure.

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éthodeType renvoyéBrève description
setFieldName(fieldName)DateTimePickerDé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.
setOnChangeAction(action)DateTimePickerDéfinit un Action que le script exécute chaque fois que l'entrée du sélecteur change.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerDéfinit le nombre de minutes de décalage du fuseau horaire par rapport à l'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 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

NomTypeDescription
fieldNameStringNom à attribuer à cette entrée.

Renvois

DateTimePicker : 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

NomTypeDescription
actionActionAction à effectuer.

Renvois

DateTimePicker : 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

NomTypeDescription
timeZoneOffsetMinsIntegerNombre de minutes de décalage du fuseau horaire par rapport à UTC.

Renvois

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.

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

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

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