Class TimePicker

시간선택기

사용자가 시간을 입력할 수 있는 입력란입니다.

Google Workspace 부가기능 및 Google Chat 앱에서 사용할 수 있습니다.

const dateTimePicker =
    CardService.newTimePicker()
        .setTitle('Enter the time.')
        .setFieldName('time_field')
        // Set default value as 3:30 AM.
        .setHours(3)
        .setMinutes(30)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

메서드

메서드반환 유형간략한 설명
addEventAction(eventAction)Widget위젯에서 실행할 수 있는 이벤트 작업을 추가합니다.
setFieldName(fieldName)TimePickerUI 상호작용이 있을 때 생성되는 이벤트 객체에서 이 선택기를 식별하는 필드 이름을 설정합니다.
setHours(hours)TimePicker입력 필드에 설정할 미리 입력된 시간 값을 설정합니다.
setId(id)Widget변형할 위젯을 식별하는 데 사용되는 할당된 고유 ID를 설정합니다.
setMinutes(minutes)TimePicker입력 필드에 설정할 미리 입력된 분 값을 설정합니다.
setOnChangeAction(action)TimePicker선택기 입력이 변경될 때마다 스크립트가 실행하는 Action을 설정합니다.
setTitle(title)TimePicker입력란 위에 표시되는 제목을 설정합니다.
setVisibility(visibility)Widget위젯의 공개 상태를 설정합니다.

자세한 문서

addEventAction(eventAction)

위젯에서 실행할 수 있는 이벤트 작업을 추가합니다.

매개변수

이름유형설명
eventActionEventAction추가할 EventAction입니다.

리턴

Widget - 연결을 위한 객체입니다.


setFieldName(fieldName)

UI 상호작용이 있을 때 생성되는 이벤트 객체에서 이 선택기를 식별하는 필드 이름을 설정합니다. 필드 이름은 사용자에게 표시됩니다. 필수입니다. 지정된 필드 이름은 고유해야 합니다.

매개변수

이름유형설명
fieldNameString이 입력에 할당할 이름입니다.

리턴

TimePicker - 이 선택기(연결용)


setHours(hours)

입력 필드에 설정할 미리 입력된 시간 값을 설정합니다.

매개변수

이름유형설명
hoursInteger입력에 배치된 기본 시간 값의 범위는 0~23입니다. 항상 양식 콜백 매개변수에서 문자열로 표현됩니다.

리턴

TimePicker - 이 선택기(연결용)


setId(id)

변형할 위젯을 식별하는 데 사용되는 할당된 고유 ID를 설정합니다. 위젯 변형은 부가기능에서만 지원됩니다.

매개변수

이름유형설명
idString위젯의 ID입니다. 64자(영문 기준)로 제한되며 `[a-zA-Z0-9-]+` 형식입니다.

리턴

Widget - 연결을 위한 이 객체


setMinutes(minutes)

입력 필드에 설정할 미리 입력된 분 값을 설정합니다.

매개변수

이름유형설명
minutesInteger입력에 배치된 기본 분 값의 범위는 0~59입니다. 항상 양식 콜백 매개변수에서 문자열로 표현됩니다.

리턴

TimePicker - 이 선택기(연결용)


setOnChangeAction(action)

선택기 입력이 변경될 때마다 스크립트가 실행하는 Action을 설정합니다.

매개변수

이름유형설명
actionAction수행할 작업입니다.

리턴

TimePicker - 이 선택기(연결용)


setTitle(title)

입력란 위에 표시되는 제목을 설정합니다.

매개변수

이름유형설명
titleString입력 필드 제목입니다.

리턴

TimePicker - 이 선택기(연결용)


setVisibility(visibility)

위젯의 공개 상태를 설정합니다. 기본값은 `VISIBLE`입니다.

매개변수

이름유형설명
visibilityVisibility위젯의 Visibility입니다.

리턴

Widget - 연결을 위한 객체입니다.