Um campo de entrada que permite aos usuários inserir um horário.
Disponível nos complementos do Google Workspace e nos apps do Google Chat.
var 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 este seletor no objeto de evento que é gerado quando há uma interação de interface. |
setHours(hours) | TimePicker | Define o valor das horas pré-preenchidas a ser definida no campo de entrada. |
setMinutes(minutes) | TimePicker | Define o valor dos minutos preenchidos automaticamente a ser configurado 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 este seletor no objeto de evento que é gerado quando há uma interação de interface. O nome do campo fica visível para o usuário. Obrigatório; o campo especificado nome precisa ser único.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
fieldName | String | O nome a ser atribuído a esta entrada. |
Retornar
TimePicker
: este seletor, para encadeamento.
setHours(hours)
Define o valor das horas pré-preenchidas a ser definida no campo de entrada.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
hours | Integer | O valor padrão da hora inserido na entrada e varia de 0 a 23. É sempre representada como uma string no formato de parâmetros de callback. |
Retornar
TimePicker
: este seletor, para encadeamento.
setMinutes(minutes)
Define o valor dos minutos preenchidos automaticamente a ser configurado no campo de entrada.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
minutes | Integer | O valor padrão dos minutos inseridos na entrada varia de 0 a 59. É sempre representada como uma string no formato de parâmetros de callback. |
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.