Um campo de entrada para os usuários inserirem um horário.
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 que é gerado quando há uma interação com a IU. |
setHours(hours) | TimePicker | Define o valor pré-preenchido a 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 um Action que o script executa sempre que a entrada do seletor é alterada. |
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 que é gerado quando há uma interação com a IU. O nome do campo fica visível para o usuário. Obrigatório. O nome do campo especificado deve 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 pré-preenchido a ser definido no campo de entrada.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
hours | Integer | O valor de hora padrão inserido na entrada varia de 0 a 23. Ele é sempre representado como uma string nos parâmetros do 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 posicionado na entrada é de 0 a 59. Ele é sempre representado como uma string nos parâmetros do 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 é alterada.
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.