Um campo de entrada que permite que os usuários insiram um horário.
Disponível para os apps do Google Workspace Add-ons e 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 |
---|---|---|
set | Time | Define o nome do campo que identifica esse seletor no objeto de evento gerado quando há uma interação com a interface. |
set | Time | Define o valor das horas preenchido previamente para ser definido no campo de entrada. |
set | Time | Define o valor de minutos pré-preenchido a ser definido no campo de entrada. |
set | Time | Define uma Action que o script executa sempre que a entrada do seletor muda. |
set | Time | Define o título exibido acima do campo de entrada. |
Documentação detalhada
set Field Name(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 |
---|---|---|
field | String | O nome a ser atribuído a essa entrada. |
Retornar
Time
: este seletor, para encadeamento.
set Hours(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
Time
: este seletor, para encadeamento.
set Minutes(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
Time
: este seletor, para encadeamento.
set On Change Action(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
Time
: este seletor, para encadeamento.
set Title(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
Time
: este seletor, para encadeamento.