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.
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 esse seletor no objeto de evento gerado quando há uma interação com a interface. |
setHours(hours) | TimePicker | Define o valor das horas preenchidas automaticamente a ser definida no campo de entrada. |
setMinutes(minutes) | TimePicker | Define o valor de minutos preenchidos automaticamente a ser definido no campo de entrada. |
setOnChangeAction(action) | TimePicker | Define um 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 está 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 à entrada. |
Retorno
TimePicker
: seletor para encadeamento.
setHours(hours)
Define o valor das horas preenchidas automaticamente a ser definida no campo de entrada.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
hours | Integer | O valor padrão de hora colocado na entrada, intervalo de 0 a 23. Ele é sempre representado como uma string nos parâmetros de callback do formulário. |
Retorno
TimePicker
: seletor para encadeamento.
setMinutes(minutes)
Define o valor de minutos preenchidos automaticamente 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. |
Retorno
TimePicker
: seletor para encadeamento.
setOnChangeAction(action)
Define um 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. |
Retorno
TimePicker
: 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. |
Retorno
TimePicker
: seletor para encadeamento.