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)	DateTimePicker	UI 상호작용이 있을 때 생성되는 이벤트 객체에서 이 선택 도구를 식별하는 필드 이름을 설정합니다.
setHostAppDataSource(hostAppDataSource)	DateTimePicker	Google 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)

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

매개변수

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

리턴

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

---

setFieldName(fieldName)

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

매개변수

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

리턴

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

매개변수

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

리턴

DateTimePicker — 연결을 위한 이 선택 도구입니다.

---

setId(id)

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

매개변수

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

리턴

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

---

setOnChangeAction(action)

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

매개변수

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

리턴

DateTimePicker — 연결을 위한 이 선택 도구입니다.

---

setTimeZoneOffsetInMins(timeZoneOffsetMins)

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

매개변수

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

리턴

DateTimePicker — 연결을 위한 이 선택 도구입니다.

---

setTitle(title)

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

매개변수

이름	유형	설명
title	String	입력란 제목입니다.

리턴

DateTimePicker — 연결을 위한 이 선택 도구입니다.

---

setValueInMsSinceEpoch(valueMsEpoch)

입력란에 설정할 미리 채워진 값을 설정합니다.

매개변수

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

리턴

DateTimePicker — 연결을 위한 이 선택 도구입니다.

---

setValueInMsSinceEpoch(valueMsEpoch)

입력란에 설정할 미리 채워진 값을 설정합니다.

매개변수

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

리턴

DateTimePicker — 연결을 위한 이 선택 도구입니다.

---

setVisibility(visibility)

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

매개변수

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

리턴

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