Class DateTimePicker

DateTimePicker

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

양식 제출 유효성 검사를 지원합니다. Action.setAllWidgetsAreRequired(allWidgetsAreRequired)이 true로 설정되거나 이 위젯이 Action.addRequiredWidget(requiredWidget)를 통해 지정된 경우 값을 선택하지 않으면 제출 작업이 차단됩니다.

Google Workspace 부가기능 및 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'),
        );

메서드

메서드반환 유형간략한 설명
addEventAction(eventAction)Widget위젯에서 실행할 수 있는 이벤트 작업을 추가합니다.
setFieldName(fieldName)DateTimePickerUI 상호작용이 있을 때 생성되는 이벤트 객체에서 이 선택기를 식별하는 필드 이름을 설정합니다.
setHostAppDataSource(hostAppDataSource)DateTimePickerGoogle Workspace Studio 에이전트에서 입력 변수가 에이전트의 다른 단계에서 datetime 출력을 허용합니다.
setId(id)Widget변형할 위젯을 식별하는 데 사용되는 할당된 고유 ID를 설정합니다.
setOnChangeAction(action)DateTimePicker선택기 입력이 변경될 때마다 스크립트가 실행하는 Action을 설정합니다.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePicker시간대가 UTC에서 오프셋되어야 하는 시간(분)을 설정합니다.
setTitle(title)DateTimePicker입력란 위에 표시되는 제목을 설정합니다.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePicker입력 필드에 설정할 사전 입력된 값을 설정합니다.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePicker입력 필드에 설정할 사전 입력된 값을 설정합니다.
setVisibility(visibility)Widget위젯의 공개 상태를 설정합니다.

자세한 문서

addEventAction(eventAction)

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

매개변수

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

리턴

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

setFieldName(fieldName)

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

매개변수

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

리턴

DateTimePicker - 이 선택기(연결용)

setHostAppDataSource(hostAppDataSource)

Google Workspace Studio 에이전트에서 입력 변수가 에이전트의 다른 단계에서 datetime 출력을 허용합니다. 예를 들어 Gmail 메일이 전송된 시간이나 캘린더 일정이 예약된 날짜를 수신합니다.

Google Workspace Studio를 확장하는 Google Workspace 부가기능에만 사용할 수 있습니다. 

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);

매개변수

이름유형설명
hostAppDataSourceHostAppDataSource데이터 소스입니다.

리턴

DateTimePicker - 이 선택기(연결용)

setId(id)

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

매개변수

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

리턴

Widget - 연결을 위한 이 객체

setOnChangeAction(action)

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

매개변수

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

리턴

DateTimePicker - 이 선택기(연결용)

setTimeZoneOffsetInMins(timeZoneOffsetMins)

시간대가 UTC에서 오프셋되어야 하는 시간(분)을 설정합니다. 설정된 경우 날짜와 시간이 지정된 시간대로 표시됩니다. 설정하지 않으면 시간이 사용자의 시간대로 표시됩니다.

매개변수

이름유형설명
timeZoneOffsetMinsInteger시간대가 UTC에서 오프셋되는 시간(분)입니다.

리턴

DateTimePicker - 이 선택기(연결용)

setTitle(title)

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

매개변수

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

리턴

DateTimePicker - 이 선택기(연결용)

setValueInMsSinceEpoch(valueMsEpoch)

입력 필드에 설정할 사전 입력된 값을 설정합니다.

매개변수

이름유형설명
valueMsEpochNumber에포크 이후 밀리초 단위로 입력에 배치된 기본값입니다. 항상 양식 콜백 매개변수에서 문자열로 표현됩니다.

리턴

DateTimePicker - 이 선택기(연결용)

setValueInMsSinceEpoch(valueMsEpoch)

입력 필드에 설정할 사전 입력된 값을 설정합니다.

매개변수

이름유형설명
valueMsEpochString에포크 이후 밀리초 단위로 문자열로 입력에 배치된 기본값입니다. 항상 양식 콜백 매개변수에서 문자열로 표현됩니다.

리턴

DateTimePicker - 이 선택기(연결용)

setVisibility(visibility)

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

매개변수

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

리턴

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