Um campo de entrada que permite que os usuários insiram uma data e hora.
Disponível nos complementos do Google Workspace e nos apps do Google Chat.
var 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 |
---|---|---|
setFieldName(fieldName) | DateTimePicker | Define o nome do campo que identifica este seletor no objeto de evento que é gerado quando há uma interação de interface. |
setOnChangeAction(action) | DateTimePicker | Define uma Action que o script executa sempre que a entrada do seletor muda. |
setTimeZoneOffsetInMins(timeZoneOffsetMins) | DateTimePicker | Define o número de minutos em que o fuso horário deve ser deslocado do UTC. |
setTitle(title) | DateTimePicker | Define o título exibido acima do campo de entrada. |
setValueInMsSinceEpoch(valueMsEpoch) | DateTimePicker | Define o valor pré-preenchido a ser definido no campo de entrada. |
setValueInMsSinceEpoch(valueMsEpoch) | DateTimePicker | Define o valor pré-preenchido a ser definido no campo de entrada. |
Documentação detalhada
setFieldName(fieldName)
Define o nome do campo que identifica este seletor no objeto de evento que é gerado quando há uma interação de interface. O nome do campo fica visível para o usuário. Obrigatório; o campo especificado nome precisa ser único.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
fieldName | String | O nome a ser atribuído a esta entrada. |
Retornar
DateTimePicker
: 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
DateTimePicker
: este seletor, para encadeamento.
setTimeZoneOffsetInMins(timeZoneOffsetMins)
Define o número de minutos em que o fuso horário deve ser deslocado do UTC. Se definido, a data e horário é exibido no fuso horário especificado. Se não for definido, o horário será exibido no campo fuso horário.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
timeZoneOffsetMins | Integer | O número de minutos de diferença entre o fuso horário e o UTC. |
Retornar
DateTimePicker
: 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
DateTimePicker
: este seletor, para encadeamento.
setValueInMsSinceEpoch(valueMsEpoch)
Define o valor pré-preenchido 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 que da época. É sempre representado como uma string no formato de parâmetros de callback. |
Retornar
DateTimePicker
: este seletor, para encadeamento.
setValueInMsSinceEpoch(valueMsEpoch)
Define o valor pré-preenchido 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 que da época. É sempre representado como uma string no formato de parâmetros de callback. |
Retornar
DateTimePicker
: este seletor, para encadeamento.