Esta página foi traduzida pela API Cloud Translation.

Class DateTimePicker

Um campo de entrada que permite que os usuários insiram uma data e hora.

Suporte à validação do envio de formulários. Quando Action.setAllWidgetsAreRequired(allWidgetsAreRequired) é definido como true ou o 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étodo	Tipo de retorno	Breve descrição
`setFieldName(fieldName)`	`DateTimePicker`	Define o nome do campo que identifica esse seletor no objeto de evento gerado quando há uma interação com a 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 que o fuso horário precisa ser compensado em relação ao UTC.
`setTitle(title)`	`DateTimePicker`	Define o título exibido acima do campo de entrada.
`setValueInMsSinceEpoch(valueMsEpoch)`	`DateTimePicker`	Define o valor preenchido previamente a ser definido no campo de entrada.
`setValueInMsSinceEpoch(valueMsEpoch)`	`DateTimePicker`	Define 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.