Class DateTimePicker

DateTimePicker

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étodoTipo de retornoBreve descrição
setFieldName(fieldName)DateTimePickerDefine o nome do campo que identifica este seletor no objeto de evento que é gerado quando há uma interação de interface.
setOnChangeAction(action)DateTimePickerDefine uma Action que o script executa sempre que a entrada do seletor muda.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerDefine o número de minutos em que o fuso horário deve ser deslocado do UTC.
setTitle(title)DateTimePickerDefine o título exibido acima do campo de entrada.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerDefine o valor pré-preenchido a ser definido no campo de entrada.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerDefine 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

NomeTipoDescrição
fieldNameStringO 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

NomeTipoDescrição
actionActionA 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

NomeTipoDescrição
timeZoneOffsetMinsIntegerO 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

NomeTipoDescrição
titleStringO 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

NomeTipoDescrição
valueMsEpochNumberO 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

NomeTipoDescrição
valueMsEpochStringO 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.