Esta página foi traduzida pela API Cloud Translation.

Class DateTimePicker

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

Disponível para complementos do Google Workspace e 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é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 um `Action` que o script executa sempre que a entrada do seletor muda.
`setTimeZoneOffsetInMins(timeZoneOffsetMins)`	`DateTimePicker`	Define o número de minutos em que o fuso horário deve ser deslocado do UTC.
`setTitle(title)`	`DateTimePicker`	Define o título exibido acima do campo de entrada.
`setValueInMsSinceEpoch(valueMsEpoch)`	`DateTimePicker`	Define o valor preenchido automaticamente a ser definido no campo de entrada.
`setValueInMsSinceEpoch(valueMsEpoch)`	`DateTimePicker`	Define o valor preenchido automaticamente 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 está visível para o usuário. Obrigatório. O nome do campo especificado precisa ser exclusivo.

Parâmetros

Nome	Tipo	Descrição
`fieldName`	`String`	O nome a ser atribuído à entrada.

Retorno

DateTimePicker: seletor para encadeamento.

`setOnChangeAction(action)`

Define um Action que o script executa sempre que a entrada do seletor muda.

Parâmetros

Nome	Tipo	Descrição
`action`	`Action`	A ação a ser tomada.

Retorno

DateTimePicker: 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 a hora serão exibidas no fuso horário especificado. Se não for definido, a hora será exibida 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.

Retorno

DateTimePicker: 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.

Retorno

DateTimePicker: seletor para encadeamento.

`setValueInMsSinceEpoch(valueMsEpoch)`

Define o valor preenchido automaticamente a ser definido no campo de entrada.

Parâmetros

Nome	Tipo	Descrição
`valueMsEpoch`	`Number`	O 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.

Retorno

DateTimePicker: seletor para encadeamento.

`setValueInMsSinceEpoch(valueMsEpoch)`

Define o valor preenchido automaticamente a ser definido no campo de entrada.

Parâmetros

Nome	Tipo	Descrição
`valueMsEpoch`	`String`	O 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.

Retorno

DateTimePicker: seletor para encadeamento.