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

메서드

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

자세한 문서

setFieldName(fieldName)

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

매개변수

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

리턴

DateTimePicker - 이 선택기(연결용)

setHostAppDataSource(hostAppDataSource)

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

Google Workspace 흐름을 확장하는 Google Workspace 부가기능의 경우 Gemini 알파 프로그램을 통해서만 사용할 수 있습니다. 

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 - 이 선택기(연결용)

setOnChangeAction(action)

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

매개변수

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

리턴

DateTimePicker - 이 선택기(연결용)

setTimeZoneOffsetInMins(timeZoneOffsetMins)

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

매개변수

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

리턴

DateTimePicker - 이 선택기(연결용)

setTitle(title)

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

매개변수

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

리턴

DateTimePicker - 이 선택기(연결용)

setValueInMsSinceEpoch(valueMsEpoch)

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

매개변수

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

리턴

DateTimePicker - 이 선택기(연결용)

setValueInMsSinceEpoch(valueMsEpoch)

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

매개변수

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

리턴

DateTimePicker - 이 선택기(연결용)