Un campo de entrada que permite a los usuarios ingresar una fecha y hora.
Está disponible para complementos de Google Workspace y apps de 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étodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
setFieldName(fieldName) | DateTimePicker | Establece el nombre de campo que identifica a este selector en el objeto de evento que se genera cuando hay una interacción de la IU. |
setOnChangeAction(action) | DateTimePicker | Establece un Action que realiza la secuencia de comandos cada vez que cambia la entrada del selector. |
setTimeZoneOffsetInMins(timeZoneOffsetMins) | DateTimePicker | Establece la cantidad de minutos en los que la zona horaria debe desviarse con respecto a UTC. |
setTitle(title) | DateTimePicker | Establece el título que se muestra sobre el campo de entrada. |
setValueInMsSinceEpoch(valueMsEpoch) | DateTimePicker | Establece el valor precompletado que se establecerá en el campo de entrada. |
setValueInMsSinceEpoch(valueMsEpoch) | DateTimePicker | Establece el valor precompletado que se establecerá en el campo de entrada. |
Documentación detallada
setFieldName(fieldName)
Establece el nombre de campo que identifica a este selector en el objeto de evento que se genera cuando hay una interacción de la IU. El nombre del campo es visible para el usuario. Obligatorio; el nombre del campo especificado debe ser único.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
fieldName | String | El nombre que se asignará a esta entrada. |
Devolvedor
DateTimePicker
: Este selector se usa para encadenamiento.
setOnChangeAction(action)
Establece un Action
que realiza la secuencia de comandos cada vez que cambia la entrada del selector.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
action | Action | La acción por realizar. |
Devolvedor
DateTimePicker
: Este selector se usa para encadenamiento.
setTimeZoneOffsetInMins(timeZoneOffsetMins)
Establece la cantidad de minutos en los que la zona horaria debe desviarse con respecto a UTC. Si se configura, la fecha y la hora se muestran en la zona horaria especificada. Si no la estableces, la hora se muestra en la zona horaria del usuario.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
timeZoneOffsetMins | Integer | El número de minutos en los que la zona horaria se diferencia de UTC. |
Devolvedor
DateTimePicker
: Este selector se usa para encadenamiento.
setTitle(title)
Establece el título que se muestra sobre el campo de entrada.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
title | String | Es el título del campo de entrada. |
Devolvedor
DateTimePicker
: Este selector se usa para encadenamiento.
setValueInMsSinceEpoch(valueMsEpoch)
Establece el valor precompletado que se establecerá en el campo de entrada.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
valueMsEpoch | Number | Es el valor predeterminado que se coloca en la entrada como un número, en milisegundos desde el ciclo de entrenamiento. Siempre se representa como una cadena en los parámetros de devolución de llamada de forma. |
Devolvedor
DateTimePicker
: Este selector se usa para encadenamiento.
setValueInMsSinceEpoch(valueMsEpoch)
Establece el valor precompletado que se establecerá en el campo de entrada.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
valueMsEpoch | String | Es el valor predeterminado que se coloca en la entrada como una cadena, en milisegundos desde el ciclo de entrenamiento. Siempre se representa como una cadena en los parámetros de devolución de llamada de forma. |
Devolvedor
DateTimePicker
: Este selector se usa para encadenamiento.