Class DateTimePicker

Seletor dedatae hora

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étodoTipo de retornoBreve descrição
setFieldName(fieldName)DateTimePickerDefine o nome do campo que identifica esse seletor no objeto de evento gerado quando há uma interação com a 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 de diferença entre o fuso horário e o UTC.
setTitle(title)DateTimePickerDefine o título exibido acima do campo de entrada.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerDefine o valor preenchido previamente a ser definido no campo de entrada.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerDefine o valor preenchido previamente 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 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

NomeTipoDescrição
fieldNameStringO nome a ser atribuído a essa 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 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

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 preenchido previamente 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 a época. 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 preenchido previamente a ser definido no campo de entrada.

Parâmetros

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

DateTimePicker: este seletor, para encadeamento.