Um campo de entrada que permite aos usuários inserir uma data e hora.
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 esse seletor no objeto de evento que é gerado quando há uma interação com a IU. |
setOnChangeAction(action) | DateTimePicker | Define um Action que o script executa sempre que a entrada do seletor é alterada. |
setTimeZoneOffsetInMins(timeZoneOffsetMins) | DateTimePicker | Define o número de minutos em que o fuso horário deve ser ajustado em relação ao 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 esse seletor no objeto de evento que é gerado quando há uma interação com a IU. O nome do campo fica visível para o usuário. Obrigatório. O nome do campo especificado deve ser exclusivo.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
fieldName | String | O nome a ser atribuído a essa entrada. |
Retornar
DateTimePicker
: este seletor, para encadeamento.
setOnChangeAction(action)
Define um Action
que o script executa sempre que a entrada do seletor é alterada.
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 ajustado em relação ao UTC. Se definida, a data e a hora serão exibidas no fuso horário especificado. Se não for definido, o horário será exibido no fuso horário do usuário.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
timeZoneOffsetMins | Integer | O número de minutos em que o fuso horário é diferente do 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 inserido 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
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 inserido 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
DateTimePicker
: este seletor, para encadeamento.