Class DateTimePicker

DateTimePicker

Um campo de entrada que permite aos usuários inserir uma data e hora.

Aceita validação de envio de formulários. Quando Action.setAllWidgetsAreRequired(allWidgetsAreRequired) é definido como true ou este widget é especificado por Action.addRequiredWidget(requiredWidget), a ação de envio é bloqueada, a menos que um valor seja selecionado.

Disponível para complementos do Google Workspace e apps 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
addEventAction(eventAction)WidgetAdiciona a ação de evento que pode ser realizada no widget.
setFieldName(fieldName)DateTimePickerDefine o nome do campo que identifica este seletor no objeto de evento gerado quando há uma interação da interface.
setHostAppDataSource(hostAppDataSource)DateTimePickerEm um agente do Google Workspace Studio, vamos fazer com que as variáveis de entrada aceitem saídas de data e hora de outras etapas do agente.
setId(id)WidgetDefine o ID exclusivo atribuído que é usado para identificar o widget a ser alterado.
setOnChangeAction(action)DateTimePickerDefine um Action que o script executa sempre que a entrada do seletor muda.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerDefine o número de minutos que o fuso horário deve ser compensado 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.
setVisibility(visibility)WidgetDefine a visibilidade do widget.

Documentação detalhada

addEventAction(eventAction)

Adiciona a ação de evento que pode ser realizada no widget.

Parâmetros

NomeTipoDescrição
eventActionEventActionO EventAction a ser adicionado.

Retornar

Widget: o objeto para encadeamento.

setFieldName(fieldName)

Define o nome do campo que identifica este seletor no objeto de evento gerado quando há uma interação da 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.

setHostAppDataSource(hostAppDataSource)

Em um agente do Google Workspace Studio, vamos fazer com que as variáveis de entrada aceitem saídas de data e hora de outras etapas do agente. Por exemplo, receber a hora em que uma mensagem do Gmail foi enviada ou a data em que um evento da agenda está programado.

Disponível apenas para complementos do Google Workspace que estendem o Google Workspace Studio. 

const workflowDataSource =
    CardService.newWorkflowDataSource().setIncludeVariables(true);

const hostAppDataSource =
    CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource);

const dateTimePicker = CardService.newDateTimePicker()
                          .setTitle('Enter the date and time.')
                          .setFieldName('date_time_field')
                          .setHostAppDataSource(hostAppDataSource);

Parâmetros

NomeTipoDescrição
hostAppDataSourceHostAppDataSourceA fonte de dados.

Retornar

DateTimePicker: este seletor, para encadeamento.

setId(id)

Define o ID exclusivo atribuído que é usado para identificar o widget a ser alterado. A mutação de widget só é compatível com complementos.

Parâmetros

NomeTipoDescrição
idStringO ID do widget, com um limite de 64 caracteres e no formato `[a-zA-Z0-9-]+`.

Retornar

Widget: este objeto, para encadeamento.

setOnChangeAction(action)

Define um 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 que o fuso horário deve ser compensado do UTC. Se definido, a data e a hora serão mostradas no fuso horário especificado. Se não for definido, a hora será mostrada no fuso horário do usuário.

Parâmetros

NomeTipoDescrição
timeZoneOffsetMinsIntegerO número de minutos que o fuso horário está deslocado do 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 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

NomeTipoDescrição
valueMsEpochStringO valor padrão colocado na entrada como uma string, 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.

setVisibility(visibility)

Define a visibilidade do widget. O valor padrão é "VISIBLE".

Parâmetros

NomeTipoDescrição
visibilityVisibilityO Visibility do widget.

Retornar

Widget: o objeto para encadeamento.