Um campo de entrada que permite aos usuários inserir uma data e hora.
Aceita validação de envio de formulários. Quando Action.setAllWidgetsAreRequired(allWidgetsAreRequired) é definido como
true ou este widget é especificado por Action.addRequiredWidget(requiredWidget), a ação de
envio é bloqueada, a menos que um valor seja selecionado.
Disponível para complementos do Google Workspace e apps do Google Chat.
const dateTimePicker = CardService.newDateTimePicker() .setTitle('Enter the date and time.') .setFieldName('date_time_field') // Set default value as Jan 1, 2018, 3:00 AM UTC. Either a number or // string is acceptable. .setValueInMsSinceEpoch(1514775600) // EDT time is 5 hours behind UTC. .setTimeZoneOffsetInMins(-5 * 60) .setOnChangeAction( CardService.newAction().setFunctionName('handleDateTimeChange'), );
Métodos
| Método | Tipo de retorno | Breve descrição |
|---|---|---|
set | Date | Define o nome do campo que identifica esse seletor no objeto de evento gerado quando há uma interação da interface. |
set | Date | Em um fluxo do Google Workspace, as variáveis de entrada aceitam saídas de data e hora de outras etapas do fluxo. |
set | Date | Define um Action que o script executa sempre que a entrada do seletor muda. |
set | Date | Define o número de minutos que o fuso horário deve ser compensado do UTC. |
set | Date | Define o título exibido acima do campo de entrada. |
set | Date | Define o valor pré-preenchido a ser definido no campo de entrada. |
set | Date | Define o valor pré-preenchido a ser definido no campo de entrada. |
Documentação detalhada
set
Define o nome do campo que identifica esse 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
| Nome | Tipo | Descrição |
|---|---|---|
field | String | O nome a ser atribuído a essa entrada. |
Retornar
Date: este seletor, para encadeamento.
set
Em um fluxo do Google Workspace, as variáveis de entrada aceitam saídas de data e hora de outras etapas do fluxo. Por exemplo, receber a hora em que uma mensagem do Gmail foi enviada ou a data em que um evento da agenda está programado.
Disponível apenas pelo programa Gemini Alpha para complementos do Google Workspace que estendem os fluxos de trabalho do Google Workspace.
const workflowDataSource = CardService.newWorkflowDataSource().setIncludeVariables(true); const hostAppDataSource = CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource); const dateTimePicker = CardService.newDateTimePicker() .setTitle('Enter the date and time.') .setFieldName('date_time_field') .setHostAppDataSource(hostAppDataSource);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
host | Host | A fonte de dados. |
Retornar
Date: este seletor, para encadeamento.
set
Define um 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
Date: este seletor, para encadeamento.
set
Define o número de minutos que o fuso horário deve ser compensado do UTC. Se definido, a data e a hora serão mostradas no fuso horário especificado. Se não for definido, a hora será mostrada no fuso horário do usuário.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
time | Integer | O número de minutos que o fuso horário está deslocado do UTC. |
Retornar
Date: este seletor, para encadeamento.
set
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
Date: este seletor, para encadeamento.
set
Define o valor pré-preenchido a ser definido no campo de entrada.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
value | Number | O valor padrão colocado na entrada como um número, em milissegundos desde o período. Ele sempre é representado como uma string nos parâmetros de callback do formulário. |
Retornar
Date: este seletor, para encadeamento.
set
Define o valor pré-preenchido a ser definido no campo de entrada.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
value | String | O valor padrão colocado na entrada como uma string, em milissegundos desde a época. Ele sempre é representado como uma string nos parâmetros de callback do formulário. |
Retornar
Date: este seletor, para encadeamento.