Class TimePicker

Seletor detempo

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étodoTipo de retornoBreve descrição
setFieldName(fieldName)TimePickerDefine o nome do campo que identifica esse seletor no objeto de evento gerado quando há uma interação com a interface.
setHours(hours)TimePickerDefine o valor das horas preenchido previamente para ser definido no campo de entrada.
setMinutes(minutes)TimePickerDefine o valor de minutos pré-preenchido a ser definido no campo de entrada.
setOnChangeAction(action)TimePickerDefine uma Action que o script executa sempre que a entrada do seletor muda.
setTitle(title)TimePickerDefine 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

NomeTipoDescrição
fieldNameStringO 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

NomeTipoDescrição
hoursIntegerO 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

NomeTipoDescrição
minutesIntegerO 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

NomeTipoDescrição
actionActionA 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

NomeTipoDescrição
titleStringO título do campo de entrada.

Retornar

TimePicker: este seletor, para encadeamento.