Class TimePicker

TimePicker

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é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 preenchidas automaticamente a ser definida no campo de entrada.
setMinutes(minutes)TimePickerDefine o valor de minutos preenchidos automaticamente a ser definido no campo de entrada.
setOnChangeAction(action)TimePickerDefine um 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 está 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 à entrada.

Retorno

TimePicker: seletor para encadeamento.


setHours(hours)

Define o valor das horas preenchidas automaticamente a ser definida no campo de entrada.

Parâmetros

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

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.

Retorno

TimePicker: seletor para encadeamento.


setOnChangeAction(action)

Define um Action que o script executa sempre que a entrada do seletor muda.

Parâmetros

NomeTipoDescrição
actionActionA ação a ser tomada.

Retorno

TimePicker: 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.

Retorno

TimePicker: seletor para encadeamento.