Class TimePicker

Seletor detempo

Um campo de entrada que permite que os usuários insiram 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
setFieldName(fieldName)	TimePicker	Define o nome do campo que identifica esse seletor no objeto de evento gerado quando há uma interação com a interface.
setHours(hours)	TimePicker	Define o valor das horas preenchido previamente para ser definido no campo de entrada.
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.

Documentação detalhada

setFieldName(fieldName)

Define o nome do campo que identifica esse seletor no objeto de evento gerado quando há uma interação com a 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: este seletor, para encadeamento.

---

setHours(hours)

Define o valor das horas preenchido previamente para ser definido no campo de entrada.

Parâmetros

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

Retornar

TimePicker: este seletor, 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 padrão de minutos colocado na entrada varia de 0 a 59. Ele é sempre representado como uma string nos parâmetros de callback do formulário.

Retornar

TimePicker: este 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: este 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: este seletor, para encadeamento.