Class TimePicker

TimePicker

Um campo de entrada que permite aos usuários inserir um horário.

Disponível para complementos do Google Workspace e apps do Google Chat. 

const dateTimePicker =
    CardService.newTimePicker()
        .setTitle('Enter the time.')
        .setFieldName('time_field')
        // Set default value as 3:30 AM.
        .setHours(3)
        .setMinutes(30)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

Métodos

MétodoTipo de retornoBreve descrição
addEventAction(eventAction)WidgetAdiciona a ação de evento que pode ser realizada no widget.
setFieldName(fieldName)TimePickerDefine o nome do campo que identifica este seletor no objeto de evento gerado quando há uma interação da interface.
setHours(hours)TimePickerDefine o valor de horas pré-preenchido a ser definido no campo de entrada.
setId(id)WidgetDefine o ID exclusivo atribuído que é usado para identificar o widget a ser alterado.
setMinutes(minutes)TimePickerDefine o valor de minutos pré-preenchido a ser definido no campo de entrada.
setOnChangeAction(action)TimePickerDefine um Action que o script executa sempre que a entrada do seletor muda.
setTitle(title)TimePickerDefine o título exibido acima do campo de entrada.
setVisibility(visibility)WidgetDefine a visibilidade do widget.

Documentação detalhada

addEventAction(eventAction)

Adiciona a ação de evento que pode ser realizada no widget.

Parâmetros

NomeTipoDescrição
eventActionEventActionO EventAction a ser adicionado.

Retornar

Widget: o objeto para encadeamento.

setFieldName(fieldName)

Define o nome do campo que identifica este seletor no objeto de evento gerado quando há uma interação da interface. O nome do campo fica visível para o usuário. Obrigatório. O nome do campo especificado precisa ser exclusivo.

Parâmetros

NomeTipoDescrição
fieldNameStringO nome a ser atribuído a essa entrada.

Retornar

TimePicker: este seletor, para encadeamento.

setHours(hours)

Define o valor de horas pré-preenchido a ser definido no campo de entrada.

Parâmetros

NomeTipoDescrição
hoursIntegerO valor padrão da hora colocado na entrada, que varia de 0 a 23. Ela sempre é representada como uma string nos parâmetros de callback do formulário.

Retornar

TimePicker: este seletor, para encadeamento.

setId(id)

Define o ID exclusivo atribuído que é usado para identificar o widget a ser alterado. A mutação de widget só é compatível com complementos.

Parâmetros

NomeTipoDescrição
idStringO ID do widget, com um limite de 64 caracteres e no formato `[a-zA-Z0-9-]+`.

Retornar

Widget: este objeto, para encadeamento.

setMinutes(minutes)

Define o valor de minutos pré-preenchido a ser definido no campo de entrada.

Parâmetros

NomeTipoDescrição
minutesIntegerO valor padrão de minutos colocado na entrada varia de 0 a 59. Ela sempre é representada como uma string nos parâmetros de callback do formulário.

Retornar

TimePicker: este seletor, para encadeamento.

setOnChangeAction(action)

Define um Action que o script executa sempre que a entrada do seletor muda.

Parâmetros

NomeTipoDescrição
actionActionA ação a ser tomada.

Retornar

TimePicker: este seletor, para encadeamento.

setTitle(title)

Define o título exibido acima do campo de entrada.

Parâmetros

NomeTipoDescrição
titleStringO título do campo de entrada.

Retornar

TimePicker: este seletor, para encadeamento.

setVisibility(visibility)

Define a visibilidade do widget. O valor padrão é "VISIBLE".

Parâmetros

NomeTipoDescrição
visibilityVisibilityO Visibility do widget.

Retornar

Widget: o objeto para encadeamento.