Class DatePicker

DatePicker

Um campo de entrada que permite inserir uma data.

Disponível para complementos do Google Workspace e apps do Google Chat.

const dateTimePicker =
    CardService.newDatePicker()
        .setTitle('Enter the date.')
        .setFieldName('date_field')
        // Set default value as Jan 1, 2018 UTC. Either a number or string is
        // acceptable.
        .setValueInMsSinceEpoch(1514775600)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

Métodos

MétodoTipo de retornoBreve descrição
addEventAction(eventAction)WidgetAdiciona a ação de evento que pode ser realizada no widget.
setFieldName(fieldName)DatePickerDefine o nome do campo que identifica este seletor no objeto de evento gerado quando há uma interação da interface.
setId(id)WidgetDefine o ID exclusivo atribuído que é usado para identificar o widget a ser alterado.
setOnChangeAction(action)DatePickerDefine um Action que o script executa sempre que a entrada do seletor muda.
setTitle(title)DatePickerDefine o título exibido acima do campo de entrada.
setValueInMsSinceEpoch(valueMsEpoch)DatePickerDefine o valor pré-preenchido a ser definido no campo de entrada.
setValueInMsSinceEpoch(valueMsEpoch)DatePickerDefine o valor pré-preenchido a ser definido no campo de entrada.
setVisibility(visibility)WidgetDefine a visibilidade do widget.

Documentação detalhada

addEventAction(eventAction)

Adiciona a ação de evento que pode ser realizada no widget.

Parâmetros

NomeTipoDescrição
eventActionEventActionO EventAction a ser adicionado.

Retornar

Widget: o objeto para encadeamento.


setFieldName(fieldName)

Define o nome do campo que identifica este seletor no objeto de evento gerado quando há uma interação da 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

DatePicker: este seletor, para encadeamento.


setId(id)

Define o ID exclusivo atribuído que é usado para identificar o widget a ser alterado. A mutação de widget só é compatível com complementos.

Parâmetros

NomeTipoDescrição
idStringO ID do widget, com um limite de 64 caracteres e no formato `[a-zA-Z0-9-]+`.

Retornar

Widget: este objeto, 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.

Retornar

DatePicker: 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

DatePicker: este seletor, para encadeamento.


setValueInMsSinceEpoch(valueMsEpoch)

Define o valor pré-preenchido a ser definido no campo de entrada.

Parâmetros

NomeTipoDescrição
valueMsEpochNumberO valor padrão colocado na entrada como um número, em milissegundos desde o período. Somente a data da hora da época é usada, e a hora da época é descartada. Ele sempre é representado como uma string nos parâmetros de callback do formulário.

Retornar

DatePicker: este seletor, para encadeamento.


setValueInMsSinceEpoch(valueMsEpoch)

Define o valor pré-preenchido a ser definido no campo de entrada.

Parâmetros

NomeTipoDescrição
valueMsEpochStringO valor padrão colocado na entrada como uma string, em milissegundos desde a época. Somente a data da hora da época é usada, e a hora da época é descartada. Ele sempre é representado como uma string nos parâmetros de callback do formulário.

Retornar

DatePicker: este seletor, para encadeamento.


setVisibility(visibility)

Define a visibilidade do widget. O valor padrão é "VISIBLE".

Parâmetros

NomeTipoDescrição
visibilityVisibilityO Visibility do widget.

Retornar

Widget: o objeto para encadeamento.