Class DatePicker

Seletor de data

Um campo de entrada que permite inserir uma data.

Disponível para os apps do Google Workspace Add-ons e 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étodo	Tipo de retorno	Breve descrição
setFieldName(fieldName)	DatePicker	Define o nome do campo que identifica esse seletor no objeto de evento gerado quando há uma interação com a interface.
setOnChangeAction(action)	DatePicker	Define uma Action que o script executa sempre que a entrada do seletor muda.
setTitle(title)	DatePicker	Define o título exibido acima do campo de entrada.
setValueInMsSinceEpoch(valueMsEpoch)	DatePicker	Define o valor preenchido previamente a ser definido no campo de entrada.
setValueInMsSinceEpoch(valueMsEpoch)	DatePicker	Define o valor preenchido previamente a ser definido no 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

Nome	Tipo	Descrição
fieldName	String	O nome a ser atribuído a essa entrada.

Retornar

DatePicker: este seletor, para encadeamento.

---

setOnChangeAction(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

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

DatePicker: este seletor, para encadeamento.

---

setValueInMsSinceEpoch(valueMsEpoch)

Define o valor preenchido previamente a ser definido no campo de entrada.

Parâmetros

Nome	Tipo	Descrição
valueMsEpoch	Number	O valor padrão colocado na entrada como um número, em milissegundos desde a época. Somente a data 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 preenchido previamente a ser definido no campo de entrada.

Parâmetros

Nome	Tipo	Descrição
valueMsEpoch	String	O valor padrão colocado na entrada como uma string, em milissegundos desde o período. Somente a data 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.