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étodo	Tipo de retorno	Breve descrição
addEventAction(eventAction)	Widget	Adiciona a ação de evento que pode ser realizada no widget.
setFieldName(fieldName)	TimePicker	Define o nome do campo que identifica esse seletor no objeto de evento gerado quando há uma interação da interface.
setHours(hours)	TimePicker	Define o valor de horas pré-preenchido a ser definido no campo de entrada.
setId(id)	Widget	Define o ID exclusivo atribuído que é usado para identificar o widget a ser modificado.
setMinutes(minutes)	TimePicker	Define o valor de minutos pré-preenchido a ser definido no campo de entrada.
setOnChangeAction(action)	TimePicker	Define uma Action que o script executa sempre que a entrada do seletor muda.
setTitle(title)	TimePicker	Define o título exibido acima do campo de entrada.
setVisibility(visibility)	Widget	Define a visibilidade do widget.

Documentação detalhada

addEventAction(eventAction)

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

Parâmetros

Nome	Tipo	Descrição
eventAction	EventAction	O EventAction a ser adicionado.

Retornar

Widget: o objeto, para encadeamento.

---

setFieldName(fieldName)

Define o nome do campo que identifica esse 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

Nome	Tipo	Descrição
fieldName	String	O nome a ser atribuído a essa entrada.

Retornar

TimePicker: esse seletor, para encadeamento.

---

setHours(hours)

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

Parâmetros

Nome	Tipo	Descrição
hours	Integer	O valor de hora padrão colocado na entrada, com intervalo de 0 a 23. Ele é sempre representado como uma string nos parâmetros de callback do formulário.

Retornar

TimePicker: esse seletor, para encadeamento.

---

setId(id)

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

Parâmetros

Nome	Tipo	Descrição
id	String	O ID do widget, com um limite de 64 caracteres e no formato `[a-zA-Z0-9-]+`.

Retornar

Widget: esse objeto, para encadeamento.

---

setMinutes(minutes)

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

Parâmetros

Nome	Tipo	Descrição
minutes	Integer	O valor de minutos padrão colocado na entrada, com intervalo de 0 a 59. Ele é sempre representado como uma string nos parâmetros de callback do formulário.

Retornar

TimePicker: esse seletor, para encadeamento.

---

setOnChangeAction(action)

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

Parâmetros

Nome	Tipo	Descrição
action	Action	A ação a ser tomada.

Retornar

TimePicker: esse seletor, para encadeamento.

---

setTitle(title)

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

Parâmetros

Nome	Tipo	Descrição
title	String	O título do campo de entrada.

Retornar

TimePicker: esse seletor, para encadeamento.

---

setVisibility(visibility)

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

Parâmetros

Nome	Tipo	Descrição
visibility	Visibility	A Visibility do widget.

Retornar

Widget: o objeto, para encadeamento.