Um campo de entrada que permite que os usuários insiram uma data e hora.
Disponível para os apps do Google Workspace Add-ons e 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 com a interface. |
set | Date | Define uma Action que o script executa sempre que a entrada do seletor muda. |
set | Date | Define o número de minutos de diferença entre o fuso horário e o UTC. |
set | Date | Define o título exibido acima do campo de entrada. |
set | Date | Define o valor preenchido previamente a ser definido no campo de entrada. |
set | Date | Define o valor preenchido previamente a ser definido no campo de entrada. |
Documentação detalhada
set Field Name(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 |
---|---|---|
field | String | O nome a ser atribuído a essa entrada. |
Retornar
Date
: este seletor, para encadeamento.
set On Change Action(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
Date
: este seletor, para encadeamento.
set Time Zone Offset In Mins(timeZoneOffsetMins)
Define o número de minutos de diferença entre o fuso horário e o UTC. Se definido, a data e a hora serão exibidas no fuso horário especificado. Se não for definido, o horário será mostrado no fuso horário do usuário.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
time | Integer | O número de minutos de diferença entre o fuso horário e o UTC. |
Retornar
Date
: este seletor, para encadeamento.
set Title(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
Date
: este seletor, para encadeamento.
set Value In Ms Since Epoch(valueMsEpoch)
Define o valor preenchido previamente 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 a época. Ele é sempre representado como uma string nos parâmetros de callback do formulário. |
Retornar
Date
: este seletor, para encadeamento.
set Value In Ms Since Epoch(valueMsEpoch)
Define o valor preenchido previamente 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 o período. Ele é sempre representado como uma string nos parâmetros de callback do formulário. |
Retornar
Date
: este seletor, para encadeamento.