Class DateTimePicker

DateTimePicker

Es un campo de entrada que permite a los usuarios ingresar una fecha y hora.

Admite la validación del envío de formularios. Cuando Action.setAllWidgetsAreRequired(allWidgetsAreRequired) se establece en true o este widget se especifica a través de Action.addRequiredWidget(requiredWidget), se bloquea la acción de envío, a menos que se seleccione un valor.

Está disponible para los complementos de Google Workspace y las apps de 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étodos

MétodoTipo de datos que se muestraDescripción breve
setFieldName(fieldName)DateTimePickerEstablece el nombre del campo que identifica este selector en el objeto de evento que se genera cuando hay una interacción de la IU.
setHostAppDataSource(hostAppDataSource)DateTimePickerEn un flujo de Google Workspace, las variables de entrada permiten aceptar resultados de fecha y hora de otros pasos del flujo.
setOnChangeAction(action)DateTimePickerEstablece un Action que la secuencia de comandos realiza cada vez que cambia la entrada del selector.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerEstablece la cantidad de minutos que la zona horaria debe tener de diferencia con respecto al UTC.
setTitle(title)DateTimePickerEstablece el título que se muestra sobre el campo de entrada.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerEstablece el valor precompletado que se establecerá en el campo de entrada.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerEstablece el valor precompletado que se establecerá en el campo de entrada.

Documentación detallada

setFieldName(fieldName)

Establece el nombre del campo que identifica este selector en el objeto de evento que se genera cuando hay una interacción de la IU. El usuario puede ver el nombre del campo. Obligatorio. El nombre de campo especificado debe ser único.

Parámetros

NombreTipoDescripción
fieldNameStringNombre que se asignará a esta entrada.

Volver

DateTimePicker: Este selector, para encadenar.

setHostAppDataSource(hostAppDataSource)

En un flujo de Google Workspace, las variables de entrada permiten aceptar resultados de fecha y hora de otros pasos del flujo. Por ejemplo, recibir la hora en que se envió un mensaje de Gmail o la fecha en la que se programó un evento de calendario

Solo está disponible a través del programa Gemini Alpha para los complementos de Google Workspace que extienden los flujos de Google Workspace. 

const workflowDataSource =
    CardService.newWorkflowDataSource().setIncludeVariables(true);

const hostAppDataSource =
    CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource);

const dateTimePicker = CardService.newDateTimePicker()
                          .setTitle('Enter the date and time.')
                          .setFieldName('date_time_field')
                          .setHostAppDataSource(hostAppDataSource);

Parámetros

NombreTipoDescripción
hostAppDataSourceHostAppDataSourceEs la fuente de datos.

Volver

DateTimePicker: Este selector, para encadenar.

setOnChangeAction(action)

Establece un Action que la secuencia de comandos realiza cada vez que cambia la entrada del selector.

Parámetros

NombreTipoDescripción
actionActionLa acción por realizar.

Volver

DateTimePicker: Este selector, para encadenar.

setTimeZoneOffsetInMins(timeZoneOffsetMins)

Establece la cantidad de minutos que la zona horaria debe tener de diferencia con respecto al UTC. Si se configura, la fecha y la hora se muestran en la zona horaria especificada. Si no se configura, la hora se muestra en la zona horaria del usuario.

Parámetros

NombreTipoDescripción
timeZoneOffsetMinsIntegerCantidad de minutos de diferencia de la zona horaria con respecto al UTC.

Volver

DateTimePicker: Este selector, para encadenar.

setTitle(title)

Establece el título que se muestra sobre el campo de entrada.

Parámetros

NombreTipoDescripción
titleStringEs el título del campo de entrada.

Volver

DateTimePicker: Este selector, para encadenar.

setValueInMsSinceEpoch(valueMsEpoch)

Establece el valor precompletado que se establecerá en el campo de entrada.

Parámetros

NombreTipoDescripción
valueMsEpochNumberValor predeterminado que se coloca en la entrada como un número, en milisegundos desde la época. Siempre se representa como una cadena en los parámetros de devolución de llamada del formulario.

Volver

DateTimePicker: Este selector, para encadenar.

setValueInMsSinceEpoch(valueMsEpoch)

Establece el valor precompletado que se establecerá en el campo de entrada.

Parámetros

NombreTipoDescripción
valueMsEpochStringValor predeterminado que se coloca en la entrada como una cadena, en milisegundos desde la época. Siempre se representa como una cadena en los parámetros de devolución de llamada del formulario.

Volver

DateTimePicker: Este selector, para encadenar.